Suspend-Service
Interrompt (suspend) un ou plusieurs services en cours d'exécution.
Syntaxe
Suspend-Service [-Name] <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Suspend-Service -DisplayName <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Suspend-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Suspend-Service envoie un message d'interruption au Contrôleur de services Windows pour chacun des services spécifiés. Le service continue à s'exécuter pendant son interruption, mais son action est arrêtée jusqu'à sa reprise (en utilisant Resume-Service, par exemple). Vous pouvez spécifier les services par leur nom de service ou leur nom d'affichage. Vous pouvez également utiliser un paramètre InputObject pour passer un objet service représentant les services à interrompre.
Paramètres
-DisplayName <string[]>
Spécifie les noms d'affichage des services à interrompre. 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[]>
Interrompt 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 à interrompre. Entrez une variable contenant les objets ou tapez une commande ou une expression permettant d'obtenir ces 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 le nom des services à interrompre. Les caractères génériques sont autorisés.
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 Suspend-Service. |
Sorties |
Aucun ou System.ServiceProcess.ServiceController Lorsque vous utilisez le paramètre PassThru, Suspend-Service génère un objet System.ServiceProcess.ServiceController représentant le service. Sinon, cette applet de commande ne génère aucune sortie. |
Remarques
Suspend-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.
En outre, Suspend-Service peut uniquement interrompre des services prenant en charge l'interruption et la reprise. Pour déterminer si un service particulier peut être interrompu, utilisez l'applet de commande Get-Service avec la propriété CanPauseAndContinue. Par exemple, « get-service wmi | Format-List name, canpauseandcontinue ». Pour rechercher tous les services pouvant être interrompus sur l'ordinateur, tapez « get-service | Where-Object {$_.canpauseandcontinue -eq "True"} ».
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>suspend-service -displayname "Telnet"
Description
-----------
Cette commande interrompt le service Telnet (Tlntsvr) sur l'ordinateur local.
Exemple 2
C:\PS>suspend-service -name lanman* -whatif
Description
-----------
Cette commande indique le résultat que vous obtiendriez si vous interrompiez les services dont le nom commence par « lanman ». Pour interrompre les services, réexécutez la commande sans le paramètre WhatIf.
Exemple 3
C:\PS>get-service schedule | suspend-service
Description
-----------
Cette commande utilise l'applet de commande Get-Service pour obtenir un objet représentant le service Planificateur de tâches (Schedule) sur l'ordinateur. L'opérateur de pipeline (|) passe le résultat à l'applet de commande Suspend-Service qui interrompt le service.
Exemple 4
C:\PS>get-service | where-object {$_.canpauseandcontinue -eq "True"} | suspend-service -confirm
Description
-----------
Cette commande interrompt tous les services pouvant être interrompus sur l'ordinateur. Elle utilise l'applet de commande Get-Service pour obtenir les objets représentant les services sur l'ordinateur. L'opérateur de pipeline (|) passe les résultats à l'applet de commande Where-Object qui sélectionne uniquement les services dont la propriété CanPauseAndContinue a la valeur « True ». Un autre opérateur de pipeline passe les résultats à l'applet de commande Suspend-Service. Le paramètre Confirm vous invite à confirmer l'interruption de chaque service.
Voir aussi
Concepts
Get-Service
Start-Service
Stop-Service
Restart-Service
Resume-Service
Set-Service
New-Service