Partager via

Stop-Computer

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

Arrête (arrête) les ordinateurs locaux et distants.

Syntaxe

Stop-Computer
    [-AsJob]
    [-DcomAuthentication <AuthenticationLevel>]
    [-WsmanAuthentication <String>]
    [-Protocol <String>]
    [[-ComputerName] <String[]>]
    [[-Credential] <PSCredential>]
    [-Impersonation <ImpersonationLevel>]
    [-ThrottleLimit <Int32>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Stop-Computer arrête les ordinateurs à distance. Il 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 travail en arrière-plan, pour spécifier les niveaux d’authentification et les autres informations d’identification, pour limiter les connexions simultanées créées pour exécuter la commande et forcer l’arrêt immédiat.

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

Exemples

Exemple 1 : Arrêter l’ordinateur local

PS C:\> Stop-Computer

Cette commande arrête l’ordinateur local.

Exemple 2 : Arrêter deux ordinateurs distants et l’ordinateur local

PS C:\> Stop-Computer -ComputerName "Server01", "Server02", "localhost"

Cette commande arrête deux ordinateurs distants, Server01 et Server02 et l’ordinateur local, identifiés comme localhost.

Exemple 3 : Arrêter les ordinateurs distants en tant que travail en arrière-plan

PS C:\> $j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
PS C:\> $results = $j | Receive-Job
PS C:\> $results

Ces commandes exécutent arrêter l’ordinateur en tant que travail en arrière-plan sur deux ordinateurs distants, puis obtenez les résultats.

La première commande spécifie le paramètre AsJob pour exécuter la commande en tant que travail en arrière-plan. La commande enregistre l’objet de travail résultant dans la variable $j.

La deuxième commande utilise un opérateur de pipeline pour envoyer l’objet de travail dans $j à receive-job, qui obtient les résultats du travail. La commande enregistre les résultats dans la variable $results.

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

Étant donné que AsJob crée le travail sur l’ordinateur local et retourne automatiquement les résultats à l’ordinateur local, vous pouvez exécuter receive-Job en tant que commande locale.

Exemple 4 : Arrêter un ordinateur distant

PS C:\> Stop-Computer -CompupterName "Server01" -Impersonation anonymous -Authentication PacketIntegrity

Cette commande arrête l’ordinateur distant Server01. La commande utilise des paramètres d’emprunt d’identité et d’authentification personnalisés.

Exemple 5 :

PS C:\> $s = Get-Content Domain01.txt
PS C:\> $c = Get-Credential domain01\admin01
PS C:\> Stop-Computer -ComputerName $s -Force -ThrottleLimit 10 -Credential $c

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

La première commande obtient une liste d’ordinateurs dans le domaine, puis les stocke dans la variable $s.

La deuxième commande obtient les informations d’identification d’un administrateur de domaine, puis les stocke dans la variable $c.

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

Paramètres

-AsJob

Indique que cette applet de commande s’exécute en tant que travail en arrière-plan.

Pour utiliser ce paramètre, les ordinateurs locaux et distants doivent être configurés pour la communication à distance et, sur Windows Vista et les versions ultérieures du système d’exploitation Windows, vous devez ouvrir Windows PowerShell à l’aide de l’option Exécuter en tant qu’administrateur. Pour plus d’informations, consultez about_Remote_Requirements.

Lorsque vous spécifiez le paramètre AsJob, la commande retourne immédiatement un objet qui représente le travail en arrière-plan. Vous pouvez continuer à travailler dans la session pendant la fin du travail. Le travail est créé sur l’ordinateur local et les résultats des ordinateurs distants sont automatiquement retournés à l’ordinateur local. Pour obtenir les résultats du travail, utilisez l’applet de commande Receive-Job.

Pour plus d’informations sur les travaux en arrière-plan Windows PowerShell, consultez about_Jobs et about_Remote_Jobs.

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

-ComputerName

Spécifie les ordinateurs à arrêter. 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 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.

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

-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

-Credential

Spécifie un compte d’utilisateur autorisé à effectuer 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 qu’un de l’applet de commande Get-Credential.

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

-DcomAuthentication

Spécifie le niveau d’authentification que cette applet de commande utilise avec WMI. stop-computer utilise WMI. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Faire défaut. Authentification Windows
  • Aucun. Aucune authentification COM
  • Relier. Authentification COM au niveau de la connexion
  • Appeler. Authentification COM au niveau de l’appel
  • Paquet. Authentification COM au niveau du paquet
  • PacketIntegrity. Authentification COM au niveau de l’intégrité des paquets
  • PacketPrivacy. Authentification COM au niveau de la confidentialité des paquets
  • Inchangé. Identique à la commande précédente

La valeur par défaut est Packet.

Pour plus d’informations sur les valeurs de ce paramètre, consultez 'énumération AuthenticationLevel dans msdn library.

Type:AuthenticationLevel
Alias:Authentication
Valeurs acceptées:Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

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

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

-Impersonation

Spécifie le niveau d’emprunt d’identité à utiliser lorsque cette applet de commande appelle WMI. stop-computer utilise WMI. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Faire défaut. Emprunt d’identité par défaut.
  • Anonyme. Masque l’identité de l’appelant.
  • Identifier. Permet aux objets d’interroger les informations d’identification de l’appelant.
  • Usurper. Permet aux objets d’utiliser les informations d’identification de l’appelant.

La valeur par défaut est Emprunt d’identité.

Type:ImpersonationLevel
Valeurs acceptées:Default, Anonymous, Identify, Impersonate, Delegate
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Protocol

Spécifie le protocole à utiliser pour redémarrer les ordinateurs. Les valeurs acceptables pour ce paramètre sont : WSMan et DCOM. La valeur par défaut est DCOM.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Type:String
Valeurs acceptées:DCOM, WSMan
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ThrottleLimit

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 une valeur de 0, la valeur par défaut 32 est utilisée.

La limite de limitation s’applique uniquement à la commande actuelle, et non à la session ou à l’ordinateur.

Type:Int32
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

-WsmanAuthentication

Spécifie le mécanisme utilisé pour authentifier les informations d’identification de l’utilisateur lorsque cette applet de commande utilise le protocole WSMan. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Basique
  • CredSSP
  • Faire défaut
  • Digérer
  • Kerberos
  • Négocier.

La valeur par défaut est Default.

Pour plus d’informations sur les valeurs de ce paramètre, consultez AuthenticationMechanism Enumeration dans msdn library.

Attention : l’authentification CredSSP (Credential Security Service Provider), dans laquelle les informations d’identification de l’utilisateur sont transmises à un ordinateur distant à authentifier, est conçue pour les commandes qui nécessitent une authentification sur plusieurs ressources, telles que l’accès à un partage réseau distant. Ce mécanisme augmente le risque de sécurité de l’opération à distance. Si l’ordinateur distant est compromis, les informations d’identification qui lui sont transmises peuvent être utilisées pour contrôler la session réseau.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Type:String
Valeurs acceptées:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas diriger l’entrée vers cette applet de commande.

Sorties

None or System.Management.Automation.RemotingJob

L’applet de commande retourne un objet System.Management.Automation.RemotingJob, si vous spécifiez le paramètre AsJob. Sinon, elle ne génère aucune sortie.

Notes

  • Cette applet de commande utilise la méthode Win32Shutdown de la classe WMI Win32_OperatingSystem.
  • Dans Windows PowerShell 2.0, le paramètre AsJob ne fonctionne pas de manière fiable lorsque vous redémarrez/arrêtez des ordinateurs distants. Dans Windows PowerShell 3.0, l’implémentation est modifiée pour résoudre ce problème.