Resume-Service

Reprend un ou plusieurs services interrompus (suspendus).

Syntaxe

Resume-Service [-Name] <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Resume-Service -DisplayName <string[]> [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Resume-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Resume-Service envoie un message de reprise au Contrôleur de services Windows pour chacun des services spécifiés. S'ils ont été interrompus, ils reprennent. S'ils sont en cours d'exécution, le message est ignoré. Vous pouvez spécifier les services à l'aide de leurs noms de services ou de leurs noms d'affichage. Il est également possible d'utiliser le paramètre InputObject pour passer un objet service représentant les services devant reprendre.

Paramètres

-DisplayName <string[]>

Spécifie les noms d'affichage des services à reprendre. 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[]>

Reprend 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 à reprendre. Entrez une variable contenant les objets ou tapez une commande ou une expression permettant d'obtenir les 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 les noms des services à reprendre.

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 Resume-Service.
Sorties	Aucun ou System.ServiceProcess.ServiceController Lorsque vous utilisez le paramètre PassThru, Resume-Service génère un objet System.ServiceProcess.ServiceController représentant le service redémarré. Sinon, cette applet de commande ne génère aucune sortie.

Remarques

L'état des services qui ont été interrompus est « Paused ». Lorsque les services reprennent, leur état devient « Running ».

Resume-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.

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>resume-service sens

Description
-----------
Cette commande déclenche la reprise du service SENS (System Event Notification Service) (le nom du service est représenté dans la commande par « sens ») sur l'ordinateur local. Elle utilise le paramètre Name pour spécifier le nom du service, mais omet le nom de paramètre car celui-ci est facultatif.

Exemple 2

C:\PS>get-service | where-object {$_.Status -eq "Paused"} | resume-service

Description
-----------
Cette commande déclenche la reprise de tous les services interrompus (suspendus) sur l'ordinateur. La première commande obtient tous les services sur l'ordinateur. L'opérateur de pipeline (|) passe les résultats à l'applet de commande Where-Object qui sélectionne les services dont la valeur de la propriété Status est « Paused (Suspendu) ». L'opérateur de pipeline suivant envoie les résultats à Resume-Service qui reprend les services suspendus.

En pratique, vous utiliseriez le paramètre WhatIf pour déterminer l'effet de la commande avant de l'exécuter sans ce paramètre.

Voir aussi

Concepts

Get-Service
Start-Service
Stop-Service
Restart-Service
Suspend-Service
Set-Service
New-Service