Partager via

Resume-Service

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

Reprend un ou plusieurs services suspendus (suspendus).

Syntaxe

Resume-Service
      [-InputObject] <ServiceController[]>
      [-PassThru]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Resume-Service
      [-Name] <String[]>
      [-PassThru]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Resume-Service
      [-PassThru]
      -DisplayName <String[]>
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Resume-Service envoie un message de reprise au contrôleur de service Windows pour chacun des services spécifiés. Si un service est suspendu, il reprend. S’il est en cours d’exécution, le message est ignoré. Vous pouvez spécifier les services par leurs noms de service ou noms d’affichage, ou vous pouvez utiliser le paramètre InputObject pour transmettre un objet de service qui représente les services que vous souhaitez reprendre.

Exemples

Exemple 1 : Reprendre un service sur l’ordinateur local

PS C:\> Resume-Service "sens"

Cette commande reprend le service De notification d’événements système sur l’ordinateur local. Le nom du service est représenté dans la commande par sens. La commande utilise le paramètre Name pour spécifier le nom du service, mais la commande omet le nom du paramètre, car le nom du paramètre est facultatif.

Exemple 2 : Reprendre tous les services suspendus

PS C:\> Get-Service | Where-Object {$_.Status -eq "Paused"} | Resume-Service

Cette commande reprend tous les services suspendus sur l’ordinateur. La commande d’applet de commande Get-Service obtient tous les services sur l’ordinateur. L’opérateur de pipeline (|) transmet les résultats à l’applet de commande Where-Object, qui sélectionne les services qui ont une propriété Status de Paused. L’opérateur de pipeline suivant envoie les résultats à Resume-Service, qui reprend les services suspendus.

Dans la pratique, vous utilisez le paramètre WhatIf pour déterminer l’effet de la commande avant de l’exécuter.

Paramètres

-Confirm

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

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

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

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Exclude

Spécifie les services omis par cette applet de commande. 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.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Include

Spécifie les services à reprendre. La valeur de ce paramètre qualifie 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.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-InputObject

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

Type:ServiceController[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie les noms de service des services à reprendre.

Type:String[]
Alias:ServiceName
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Retourne un objet qui représente le service. Par défaut, cette applet de commande ne génère aucune sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 repris, si vous spécifiez le paramètre PassThru. Sinon, cette applet de commande ne génère aucune sortie.

Notes

  • L’état des services qui ont été suspendus est suspendu. Lorsque les services sont repris, leur état est En cours d’exécution.
  • resume-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.
  • 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.