Partager via

Suspend-Service

  • Référence
Module:
Microsoft.PowerShell.Management

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

L’applet Suspend-Service de commande envoie un message de suspension au contrôleur de service Windows pour chacun des services spécifiés. Bien qu’il soit suspendu, le service est toujours en cours d’exécution, mais son action est arrêtée jusqu’à la reprise, 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 passer 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 passerait si vous suspendiez 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 Get-Service de 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 suspend 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 $True pipeline transmet les résultats à l’applet Where-Object de commande, qui sélectionne uniquement les services dont la valeur est 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 vous pouvez 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’applet Get-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, tapez Get-Service | Where-Object {$_.CanPauseAndContinue -eq $true}.
  • Pour rechercher les noms de service et les noms complets des services sur votre système, tapez Get-Service. Les noms de service apparaissent dans la colonne Nom , et les noms complets apparaissent dans la colonne DisplayName .