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.

# `AWSSupport-ManageWindowsService`
<a name="automation-awssupport-managewindowsservice"></a>

 **Description** 

Le `AWSSupport-ManageWindowsService` runbook vous permet d'arrêter, de démarrer, de redémarrer, de suspendre ou de désactiver n'importe quel service Windows sur l'instance cible.

[Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-ManageWindowsService)

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

Windows

**Paramètres**
+ AutomationAssumeRole

  Type : String

  Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
+ InstanceId

  Type : String

  Description : (Obligatoire) L'ID de l'instance gérée pour gérer les services de.
+ ServiceAction

  Type : String

  Valeurs valides : Vérifier \$1 Redémarrer \$1 Forcer le redémarrage \$1 Démarrer \$1 Arrêter \$1 Forcer l'arrêt \$1 Pause

  Par défaut : Check

  Description : (Obligatoire) Action à appliquer au service Windows. Notez que `Force-Restart` et `Force-Stop` peut être utilisé pour redémarrer et arrêter un service qui possède des services dépendants. 
+ StartupType

  Type : String

  Valeurs valides : Vérifier \$1 Auto \$1 Demande \$1 Désactivé \$1 DelayedAutoStart

  Par défaut : Check

  Description : (Obligatoire) Type de démarrage à appliquer au service Windows.
+ WindowsServiceName

  Type : String

  Description : (Obligatoire) nom de service Windows valide.

**Autorisations IAM requises**

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

Il est recommandé que l' EC2 instance recevant la commande ait un rôle IAM associé à la politique gérée par **SSMManagedInstanceCoreAmazon**. L'utilisateur doit avoir au moins **ssm : StartAutomationExecution** et **ssm : SendCommand** pour exécuter l'automatisation et envoyer la commande à l'instance, plus **ssm : GetAutomationExecution** pour pouvoir lire le résultat de l'automatisation.

 **Étapes de document** 

`aws:runCommand`- Exécutez le PowerShell script pour appliquer la configuration souhaitée au service Windows sur l'instance cible.

 **Sorties** 

manageWindowsService.Sortie