

文档 AWS SDK 示例 GitHub 存储库中还有更多 [S AWS DK 示例](https://github.com/awsdocs/aws-doc-sdk-examples)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 将 `DescribeInstanceHealth` 与 CLI 配合使用
<a name="elastic-load-balancing_example_elastic-load-balancing_DescribeInstanceHealth_section"></a>

以下代码示例演示如何使用 `DescribeInstanceHealth`。

------
#### [ CLI ]

**AWS CLI**  
**描述负载均衡器多个实例的运行状况**  
此示例描述指定负载均衡器多个实例的运行状况。  
命令:  

```
aws elb describe-instance-health --load-balancer-name {{my-load-balancer}}
```
输出：  

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-207d9717",
          "ReasonCode": "N/A",
          "State": "InService",
          "Description": "N/A"
      },
      {
          "InstanceId": "i-afefb49b",
          "ReasonCode": "N/A",
          "State": "InService",
          "Description": "N/A"
      }
  ]
}
```
**描述负载均衡器单个实例的运行状况**  
此示例描述指定负载均衡器指定实例的运行状况。  
命令:  

```
aws elb describe-instance-health --load-balancer-name {{my-load-balancer}} --instances {{i-7299c809}}
```
以下是正在注册的实例的示例响应。  
输出：  

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-7299c809",
          "ReasonCode": "ELB",
          "State": "OutOfService",
          "Description": "Instance registration is still in progress."
    }
  ]
}
```
以下是运行状况不佳的实例的示例响应。  
输出：  

```
{
  "InstanceStates": [
      {
          "InstanceId": "i-7299c809",
          "ReasonCode": "Instance",
          "State": "OutOfService",
          "Description": "Instance has failed at least the UnhealthyThreshold number of health checks consecutively."
      }
  ]
}
```
+  有关 API 的详细信息，请参阅*AWS CLI 命令参考[DescribeInstanceHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/elb/describe-instance-health.html)*中的。

------
#### [ PowerShell ]

**适用于 PowerShell V4 的工具**  
**示例 1：此示例描述向指定负载均衡器注册的实例的状态。**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer
```
**输出**：  

```
Description                   InstanceId                    ReasonCode                    State
-----------                   ----------                    ----------                    -----
N/A                           i-87654321                    N/A                           InService
Instance has failed at lea... i-12345678                    Instance                      OutOfService
```
**示例 2：此示例描述向指定负载均衡器注册的指定实例的状态。**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678
```
**示例 3：此示例显示指定实例的状态的完整描述。**  

```
(Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678).Description
```
**输出**：  

```
Instance has failed at least the UnhealthyThreshold number of health checks consecutively.
```
+  有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 4) [DescribeInstanceHealth](https://docs.aws.amazon.com/powershell/v4/reference)中的。

**适用于 PowerShell V5 的工具**  
**示例 1：此示例描述向指定负载均衡器注册的实例的状态。**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer
```
**输出**：  

```
Description                   InstanceId                    ReasonCode                    State
-----------                   ----------                    ----------                    -----
N/A                           i-87654321                    N/A                           InService
Instance has failed at lea... i-12345678                    Instance                      OutOfService
```
**示例 2：此示例描述向指定负载均衡器注册的指定实例的状态。**  

```
Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678
```
**示例 3：此示例显示指定实例的状态的完整描述。**  

```
(Get-ELBInstanceHealth -LoadBalancerName my-load-balancer -Instance i-12345678).Description
```
**输出**：  

```
Instance has failed at least the UnhealthyThreshold number of health checks consecutively.
```
+  有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeInstanceHealth](https://docs.aws.amazon.com/powershell/v5/reference)中的。

------