Arrête les ordinateurs locaux et distants.

Syntaxe

Stop-Computer [[-ComputerName] <string[]>] [[-Credential] <PSCredential>] [-AsJob] [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Force] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Stop-Computer arrête les ordinateurs à distance. Elle peut également arrêter l'ordinateur local.

Vous pouvez utiliser les paramètres de Stop-Computer pour exécuter les opérations d'arrêt en tant que tâche en arrière-plan, spécifier les niveaux d'authentification et d'autres informations d'identification, limiter les connexions simultanées créées pour exécuter la commande et forcer un arrêt immédiat.

Cette applet de commande ne requiert pas la communication à distance Windows PowerShell, sauf si vous utilisez le paramètre AsJob.

Paramètres

-AsJob

Exécute la commande en tant que tâche en arrière-plan.

Remarque : pour utiliser ce paramètre, les ordinateurs locaux et distants doivent être configurés pour la communication à distance et, sous Windows Vista et les versions ultérieures de Windows, vous devez ouvrir Windows PowerShell avec l'option Exécuter en tant qu'administrateur. Pour plus d'informations, consultez about_Remote_Requirements.

Lorsque vous utilisez le paramètre AsJob, la commande retourne immédiatement un objet qui représente la tâche en arrière-plan. Vous pouvez continuer à travailler dans la session pendant l'exécution de la tâche. La tâche est créée sur l'ordinateur local et les résultats provenant d'ordinateurs distants sont automatiquement retournés à l'ordinateur local. Pour gérer la tâche, utilisez les applets de commande Job. Pour obtenir les résultats de la tâche, utilisez l'applet de commande Receive-Job.

Pour plus d'informations sur les tâches en arrière-plan Windows PowerShell, consultez about_Jobs et about_Remote_Jobs.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Authentication <AuthenticationLevel>

Spécifie le niveau d'authentification utilisé pour la connexion WMI (Stop-Computer utilise WMI). La valeur par défaut est Packet.

Les valeurs valides sont :

Unchanged : le niveau d'authentification est le même que pour la commande précédente.

Default : authentification Windows.

None : aucune authentification COM.

Connect : authentification COM au niveau de la connexion.

Call : authentification COM au niveau de l'appel.

Packet : authentification COM au niveau du paquet

PacketIntegrity : authentification COM au niveau de l'intégrité du paquet.

PacketPrivacy : authentification COM au niveau de la confidentialité du paquet

Obligatoire ?

false

Position ?

named

Valeur par défaut

4

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-ComputerName <string[]>

Arrête les ordinateurs spécifiés. La valeur par défaut est l'ordinateur local.

Tapez le nom NETBIOS, l'adresse IP ou le nom de domaine complet d'un ou de plusieurs ordinateurs dans une liste séparée par des virgules. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur ou « localhost ».

Ce paramètre ne s'appuie pas sur la communication à distance Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName même si votre ordinateur n'est pas configuré pour exécuter des commandes distantes.

Obligatoire ?

false

Position ?

1

Valeur par défaut

.

Accepter l'entrée de pipeline ?

true (ByPropertyName)

Accepter les caractères génériques ?

false

-Credential <PSCredential>

Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel.

Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 », ou entrez un objet PSCredential, tel que celui généré par l'applet de commande Get-Credential.

Obligatoire ?

false

Position ?

2

Valeur par défaut

Current user

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Force

Force l'arrêt immédiat des ordinateurs.

Obligatoire ?

false

Position ?

named

Valeur par défaut

False

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Impersonation <ImpersonationLevel>

Spécifie le niveau d'emprunt d'identité à utiliser lors de l'appel de WMI (Stop-Computer utilise WMI). La valeur par défaut est « Impersonate ».

Les valeurs valides sont :

Default : emprunt d'identité par défaut

Anonymous : masque l'identité de l'appelant.

Identify : permet aux objets d'interroger les informations d'identification de l'appelant.

Impersonate : permet aux objets d'utiliser les informations d'identification de l'appelant.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Impersonate

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-ThrottleLimit <int>

Spécifie le nombre maximal de connexions simultanées qui peuvent être établies pour exécuter cette commande. Si vous omettez ce paramètre ou entrez la valeur 0, la valeur par défaut 32 est utilisée.

La limite d'accélération s'applique uniquement à la commande actuelle, et non à la session ou à l'ordinateur.

Obligatoire ?

false

Position ?

named

Valeur par défaut

32

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

None

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Sorties

Aucun ou System.Management.Automation.RemotingJob

Lorsque vous utilisez le paramètre AsJob, l'applet de commande retourne un objet de traitement (System.Management.Automation.RemotingJob). Sinon, elle ne génère aucune sortie.

Remarques

Cette applet de commande utilise la méthode Win32Shutdown de la classe WMI Win32_OperatingSystem.

Exemple 1

C:\PS>stop-computer

Description
-----------
Cette commande arrête l'ordinateur local.






Exemple 2

C:\PS>stop-computer -computername Server01, Server02, localhost

Description
-----------
Cette commande arrête deux ordinateurs distants (Server01 et Server02) et l'ordinateur local (identifié par « localhost »).






Exemple 3

C:\PS>$j = stop-computer -computername Server01, Server02 -asjob 

C:\PS> $results = $j | receive-job

C:\PS> $results

Description
-----------
Ces commandes exécutent une commande Stop-Computer en tant que tâche en arrière-plan sur deux ordinateurs distants, puis obtient les résultats.

La première commande utilise le paramètre AsJob pour exécuter la commande en tant que tâche en arrière-plan. La commande enregistre l'objet de traitement résultant dans la variable $j.

La deuxième commande utilise un opérateur de pipeline pour envoyer l'objet de traitement qui figure dans $j à l'applet de commande Receive-Job, qui obtient les résultats de la tâche. La commande enregistre les résultats dans la variable $results. 

La troisième commande affiche le résultat enregistré dans la variable $results.

Comme le paramètre AsJob crée la tâche sur l'ordinateur local et retourne automatiquement les résultats à l'ordinateur local, vous pouvez exécuter la commande Receive-Job en tant que commande locale.






Exemple 4

C:\PS>stop-computer -comp Server01 -impersonation anonymous -authentication PacketIntegrity

Description
-----------
Cette commande redémarre l'ordinateur distant Server01. La commande utilise des paramètres d'authentification et d'emprunt d'identité personnalisés.






Exemple 5

C:\PS>$s = get-content domain01.txt

C:\PS> $c = get-credential domain01\admin01

C:\PS> stop-computer -computername $s -force -throttlelimit 10 -credential $c

Description
-----------
Ces commandes forcent l'arrêt immédiat de tous les ordinateurs dans Domain01. 

La première commande obtient la liste des ordinateurs du domaine et l'enregistre dans la variable $s.

La deuxième commande obtient les informations d'identification d'un administrateur de domaine et les enregistre dans la variable $c.

La troisième commande arrête les ordinateurs. Elle utilise le paramètre ComputerName pour envoyer la liste des ordinateurs figurant dans la variable $s, le paramètre Force pour forcer un arrêt immédiat et le paramètre Credential pour envoyer les informations d'identification enregistrées dans la variable $c. Elle utilise également le paramètre ThrottleLimit pour limiter la commande à 10 connexions simultanées.






Voir aussi




Table des matières