

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Utilisation de `SetInstanceHealth` avec une CLI
<a name="example_auto-scaling_SetInstanceHealth_section"></a>

Les exemples de code suivants illustrent comment utiliser `SetInstanceHealth`.

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

**AWS CLI**  
**Pour définir le statut d’état d’une instance**  
Cet exemple définit le statut d’état de l’instance spécifiée sur `Unhealthy`.  

```
aws autoscaling set-instance-health \
    --instance-id i-061c63c5eb45f0416 \
    --health-status Unhealthy
```
Cette commande ne produit aucune sortie.  
+  Pour plus de détails sur l'API, voir [SetInstanceHealth](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/set-instance-health.html)la section *Référence des AWS CLI commandes*. 

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

**Outils pour PowerShell V4**  
**Exemple 1 : cet exemple définit le statut de l’instance spécifiée sur « Non fonctionnelle », la mettant hors service. Auto Scaling résilie l’instance et la remplace.**  

```
Set-ASInstanceHealth -HealthStatus Unhealthy -InstanceId i-93633f9b
```
**Exemple 2 : cet exemple définit le statut de l’instance spécifiée sur « Saine », afin de la maintenir en service. Aucune période de grâce de la surveillance de l’état pour le groupe Auto Scaling n’est respectée.**  

```
Set-ASInstanceHealth -HealthStatus Healthy -InstanceId i-93633f9b -ShouldRespectGracePeriod $false
```
+  Pour plus de détails sur l'API, reportez-vous [SetInstanceHealth](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

**Outils pour PowerShell V5**  
**Exemple 1 : cet exemple définit le statut de l’instance spécifiée sur « Non fonctionnelle », la mettant hors service. Auto Scaling résilie l’instance et la remplace.**  

```
Set-ASInstanceHealth -HealthStatus Unhealthy -InstanceId i-93633f9b
```
**Exemple 2 : cet exemple définit le statut de l’instance spécifiée sur « Saine », afin de la maintenir en service. Aucune période de grâce de la surveillance de l’état pour le groupe Auto Scaling n’est respectée.**  

```
Set-ASInstanceHealth -HealthStatus Healthy -InstanceId i-93633f9b -ShouldRespectGracePeriod $false
```
+  Pour plus de détails sur l'API, reportez-vous [SetInstanceHealth](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*. 

------

Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de ce service avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.