Reprend un ou plusieurs services interrompus (suspendus).
Syntaxe
Resume-Service [-Name] <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Resume-Service -DisplayName <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Resume-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Resume-Service envoie un message de reprise au Contrôleur de services Windows pour chacun des services spécifiés. S'ils ont été interrompus, ils reprennent. S'ils sont en cours d'exécution, le message est ignoré. Vous pouvez spécifier les services à l'aide de leurs noms de services ou de leurs noms d'affichage. Il est également possible d'utiliser le paramètre InputObject pour passer un objet service représentant les services devant reprendre.
Paramètres
-DisplayName <string[]>
Spécifie les noms d'affichage des services à reprendre. Les caractères génériques sont autorisés.
|
Obligatoire ? |
true |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Exclude <string[]>
Omet les services spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément ou un modèle de nom, tel que « s* ». Les caractères génériques sont autorisés.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Include <string[]>
Reprend uniquement les services spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément ou un modèle de nom, tel que « s* ». Les caractères génériques sont autorisés.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-InputObject <ServiceController[]>
Spécifie les objets ServiceController représentant les services à reprendre. Entrez une variable contenant les objets ou tapez une commande ou une expression permettant d'obtenir les objets.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
|
Accepter les caractères génériques ? |
false |
-Name <string[]>
Spécifie les noms des services à reprendre.
Le nom de paramètre est facultatif. Vous pouvez utiliser « -Name » ou son alias, « -ServiceName », ou encore omettre le nom de paramètre.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-PassThru
Retourne un objet représentant le service. Par défaut, cette applet de commande ne génère aucune sortie.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Confirm
Vous invite à confirmer l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
System.ServiceProcess.ServiceController ou System.String Vous pouvez diriger un objet service ou une chaîne qui contient un nom de service vers Resume-Service. |
|
Sorties |
Aucun ou System.ServiceProcess.ServiceController Lorsque vous utilisez le paramètre PassThru, Resume-Service génère un objet System.ServiceProcess.ServiceController représentant le service redémarré. Sinon, cette applet de commande ne génère aucune sortie. |
Remarques
L'état des services qui ont été interrompus est « Paused ». Lorsque les services reprennent, leur état devient « Running ».
Resume-Service peut contrôler des services seulement lorsque l'utilisateur actuel est autorisé à le faire. Si une commande ne fonctionne pas correctement, cela signifie peut-être que vous ne disposez pas des autorisations requises.
Pour rechercher les noms de services et les noms d'affichage des services sur votre système, tapez « get-service ». Les noms de services figurent dans la colonne Name et les noms d'affichage apparaissent dans la colonne DisplayName.
Exemple 1
C:\PS>resume-service sens Description ----------- Cette commande déclenche la reprise du service SENS (System Event Notification Service) (le nom du service est représenté dans la commande par « sens ») sur l'ordinateur local. Elle utilise le paramètre Name pour spécifier le nom du service, mais omet le nom de paramètre car celui-ci est facultatif.
Exemple 2
C:\PS>get-service | where-object {$_.Status -eq "Paused"} | resume-service
Description
-----------
Cette commande déclenche la reprise de tous les services interrompus (suspendus) sur l'ordinateur. La première commande obtient tous les services sur l'ordinateur. L'opérateur de pipeline (|) passe les résultats à l'applet de commande Where-Object qui sélectionne les services dont la valeur de la propriété Status est « Paused (Suspendu) ». L'opérateur de pipeline suivant envoie les résultats à Resume-Service qui reprend les services suspendus.
En pratique, vous utiliseriez le paramètre WhatIf pour déterminer l'effet de la commande avant de l'exécuter sans ce paramètre.
Voir aussi