Suspend-Service
Interrompt (suspend) un ou plusieurs services en cours d'exécution.
Syntax
Suspend-Service
[-InputObject] <ServiceController[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Suspend-Service
[-Name] <String[]>
[-PassThru]
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Suspend-Service
[-PassThru]
-DisplayName <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cette applet de commande est disponible uniquement sur la plateforme Windows.
L’applet Suspend-Service
de commande envoie un message de suspension au contrôleur de service Windows pour chacun des services spécifiés. Pendant sa suspension, le service est toujours en cours d’exécution, mais son action est arrêtée jusqu’à ce qu’elle ait repris, par exemple à l’aide de l’applet Resume-Service
de commande. Vous pouvez spécifier les services par leur nom de service ou leur nom d’affichage, ou vous pouvez utiliser le paramètre InputObject pour transmettre un objet de service qui représente les services que vous souhaitez suspendre.
Exemples
Exemple 1 : Suspendre un service
PS C:\> Suspend-Service -DisplayName "Telnet"
Cette commande interrompt le service Telnet (Tlntsvr) sur l’ordinateur local.
Exemple 2 : Afficher ce qui se produirait si vous suspendez les services
PS C:\> Suspend-Service -Name lanman* -WhatIf
Cette commande indique ce qui se passerait si vous suspendiez les services dont le nom commence par lanman. Pour suspendre les services, réexécutez la commande sans le paramètre WhatIf .
Exemple 3 : Obtenir et suspendre un service
PS C:\> Get-Service schedule | Suspend-Service
Cette commande utilise l’applet de Get-Service
commande pour obtenir un objet qui représente le service Planificateur de tâches (Schedule) sur l’ordinateur. L’opérateur de pipeline (|
) transmet le résultat à Suspend-Service
, ce qui interrompt le service.
Exemple 4 : Suspendre tous les services qui peuvent être suspendus
PS C:\> Get-Service | Where-Object {$_.CanPauseAndContinue -eq "True"} | Suspend-Service -Confirm
Cette commande interrompt tous les services pouvant être interrompus sur l’ordinateur. Il utilise Get-Service
pour obtenir des objets qui représentent les services sur l’ordinateur. L’opérateur de pipeline transmet les résultats à l’applet Where-Object
de commande, qui sélectionne uniquement les services dont la valeur est $True
pour la propriété CanPauseAndContinue . Un autre opérateur de pipeline transmet les résultats à Suspend-Service
. Le paramètre Confirm vous invite à confirmer avant de suspendre chacun des services.
Paramètres
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Spécifie les noms d’affichage des services à interrompre. Les caractères génériques sont autorisés.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Spécifie les services à omettre des 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Include
Spécifie les services à suspendre. 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-InputObject
Spécifie les objets ServiceController qui représentent les services à suspendre. Entrez une variable contenant les objets, ou tapez une commande ou une expression qui obtient ces objets.
Type: | ServiceController[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Spécifie les noms de service des services à suspendre. 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 omettre le nom du paramètre.
Type: | String[] |
Aliases: | ServiceName |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-PassThru
Retourne un objet représentant l’élément que vous utilisez. Par défaut, cette applet de commande ne génère aucun résultat.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
System.ServiceProcess.ServiceController, System.String
Vous pouvez diriger un objet de service ou une chaîne qui contient un nom de service vers cette applet de commande.
Sorties
None, System.ServiceProcess.ServiceController
Cette applet de commande génère un objet System.ServiceProcess.ServiceController qui représente le service, si vous spécifiez le paramètre PassThru . Sinon, cette applet de commande ne génère aucune sortie.
Notes
Cette applet de commande est disponible uniquement sur les plateformes Windows.
Suspend-Service
peut contrôler les services uniquement 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.Suspend-Service
peut suspendre uniquement les services qui prennent en charge la suspension et la reprise. Pour déterminer si un service particulier peut être suspendu, utilisez l’appletGet-Service
de commande avec la propriété CanPauseAndContinue . Par exemple :Get-Service wmi | Format-List Name, CanPauseAndContinue
. Pour rechercher tous les services sur l’ordinateur qui peuvent être suspendus, tapezGet-Service | Where-Object {$_.CanPauseAndContinue -eq $true}
.- Pour rechercher les noms de service et les noms d’affichage des services sur votre système, tapez
Get-Service
. Les noms de service s’affichent dans la colonne Nom et les noms d’affichage apparaissent dans la colonne DisplayName .