Partager via


Suspend-Service

Suspend (interrompt) un ou plusieurs services en cours d’exécution.

Syntaxe

InputObject (Par défaut)

Suspend-Service
    [-InputObject] <ServiceController[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default

Suspend-Service
    [-Name] <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DisplayName

Suspend-Service
    -DisplayName <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

La cmdlet Suspend-Service envoie un message de suspension au contrôleur de service Windows pour chacun des services spécifiés. Pendant la suspension, 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 de commande Resume-Service. Vous pouvez spécifier les services par leurs noms de service ou noms 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 de service Telnet (Tlntsvr) sur l’ordinateur local.

Exemple 2 : Afficher ce qui se passerait si vous suspendez les services

PS C:\> Suspend-Service -Name lanman* -WhatIf

Cette commande indique ce qui se passerait si vous avez suspendu les services qui ont un nom de service qui 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 commande Get-Service pour obtenir un objet qui représente le service Planificateur de tâches (Planification) sur l’ordinateur. L’opérateur de pipeline (|) transmet le résultat à Suspend-Service, 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 sur l’ordinateur qui peuvent être suspendus. 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 de commande Where-Object, 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 Confirmer vous invite à confirmer avant de suspendre chacun des services.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DisplayName

Spécifie les noms complets des services à suspendre. Les caractères génériques sont autorisés.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

DisplayName
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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 de nom ou un modèle, tel que « s* ». Les caractères génériques sont autorisés.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Include

Spécifie les services à suspendre. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément de nom ou un modèle, tel que « s* ». Les caractères génériques sont autorisés.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-InputObject

Spécifie Objet ServiceController qui représentent les services à suspendre. Entrez une variable qui contient les objets, ou tapez une commande ou une expression qui obtient les objets.

Propriétés du paramètre

Type:

ServiceController[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

InputObject
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

Spécifie les noms de service des services à suspendre. Les caractères génériques sont autorisés.

Le nom du paramètre est facultatif. Vous pouvez utiliser Nom ou son alias, ServiceName, ou vous pouvez omettre le nom du paramètre.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False
Alias:Nom du Service

Jeux de paramètres

Default
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PassThru

Retourne un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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

  • suspend-Service ne peut contrôler les services que lorsque l’utilisateur actuel est autorisé à le faire. Si une commande ne fonctionne pas correctement, vous n’avez peut-être pas les autorisations requises.
  • suspend-Service ne peut suspendre que les services qui prennent en charge la suspension et la reprise. Pour déterminer si un service particulier peut être suspendu, 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 sur l’ordinateur qui peuvent être suspendus, tapez Get-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 apparaissent dans la colonne Nom et les noms d’affichage apparaissent dans la colonne DisplayName.