Partager via

Stop-Computer

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

Arrête les ordinateurs locaux et distants.

Syntax

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

Description

L’applet Stop-Computer de commande arrête l’ordinateur local et les ordinateurs distants.

Vous pouvez utiliser les paramètres de l’exécution des Stop-Computer 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 PowerShell, sauf si vous utilisez le paramètre AsJob .

Exemples

Exemple 1 : Arrêter l’ordinateur local

Cet exemple montre comment arrêter l’ordinateur local.

Stop-Computer -ComputerName localhost

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

Cet exemple montre comment arrêter deux ordinateurs distants et l’ordinateur local.

Stop-Computer -ComputerName "Server01", "Server02", "localhost"

Stop-Computer utilise le paramètre ComputerName pour spécifier deux ordinateurs distants et l’ordinateur local. Chaque ordinateur est arrêté.

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

Dans cet exemple, Stop-Computer s’exécute en tant que travail en arrière-plan sur deux ordinateurs distants.

$j = Stop-Computer -ComputerName "Server01", "Server02" -AsJob
$results = $j | Receive-Job
$results

Stop-Computer utilise le paramètre ComputerName pour spécifier deux ordinateurs distants. Le paramètre AsJob exécute la commande en tant que travail en arrière-plan. Les objets de travail sont stockés dans la $j variable.

Les objets de travail de la $j variable sont envoyés vers le bas du pipeline Receive-Job, ce qui obtient les résultats du travail. Les objets sont stockés dans la $results variable. La $results variable affiche les informations de travail dans la console PowerShell.

É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

Cet exemple montre comment arrêter un ordinateur distant à l’aide de l’authentification spécifiée.

Stop-Computer -ComputerName "Server01" -Impersonation Anonymous -DcomAuthentication PacketIntegrity

Stop-Computer utilise le paramètre ComputerName pour spécifier l’ordinateur distant. Le paramètre Impersonation spécifie un emprunt d’identité personnalisé et le paramètre DcomAuthentication spécifie les paramètres au niveau de l’authentification.

Exemple 5 : Arrêter les ordinateurs dans un domaine

Dans cet exemple, les commandes forcent l’arrêt immédiat de tous les ordinateurs d’un domaine spécifié.

$s = Get-Content -Path ./Domain01.txt
$c = Get-Credential -Credential Domain01\Admin01
Stop-Computer -ComputerName $s -Force -ThrottleLimit 10 -Credential $c

Get-Content utilise le paramètre Path pour obtenir un fichier dans le répertoire actif avec la liste des ordinateurs de domaine. Les objets sont stockés dans la $s variable.

Get-Credential utilise le paramètre Credential pour spécifier les informations d’identification d’un administrateur de domaine. Les informations d’identification sont stockées dans la $c variable.

Stop-Computer arrête les ordinateurs spécifiés avec la liste des ordinateurs du paramètre ComputerName dans la $s variable. Le paramètre Force force un arrêt immédiat. Le paramètre ThrottleLimit limite la commande à 10 connexions simultanées. Le paramètre Credential envoie les informations d’identification enregistrées dans la $c variable.

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 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 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 obtenir les résultats du travail, utilisez l’applet Receive-Job de commande.

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 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 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[]
Aliases:CN, __SERVER, Server, IPAddress
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 généré par l’applet Get-Credential de commande. Si vous tapez un nom d’utilisateur, vous êtes invité à entrer le mot de passe.

Les informations d’identification sont stockées dans un objet PSCredential et le mot de passe est stocké en tant que SecureString.

Remarque

Pour plus d’informations sur la protection des données SecureString , consultez Comment secure is SecureString ?.

Type:PSCredential
Position:1
Default value:Current user
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DcomAuthentication

Spécifie le niveau d’authentification que cette applet de commande utilise avec WMI. Stop-Computer utilise WMI. La valeur par défaut est Packet.

Les valeurs valides pour ce paramètre sont :

  • Valeur par défaut : Authentification Windows.
  • Aucun : Aucune authentification COM.
  • Connecter : authentification COM au niveau Connecter.
  • Appel : 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.

Pour plus d’informations sur les valeurs de ce paramètre, consultez AuthenticationLevel.

Type:AuthenticationLevel
Aliases:Authentication
Accepted values:Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Position:Named
Default value:Packet
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Force l’arrêt immédiat de l’ordinateur.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Impersonation

Spécifie le niveau d’emprunt d’identité à utiliser lorsque cette applet de commande appelle WMI. La valeur par défaut est Emprunt d’identité.

Stop-Computer utilise WMI. Les valeurs valides pour ce paramètre sont :

  • Valeur par 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.
  • Emprunt d’identité : permet aux objets d’utiliser les informations d’identification de l’appelant.
Type:ImpersonationLevel
Accepted values:Default, Anonymous, Identify, Impersonate, Delegate
Position:Named
Default value:Impersonate
Required:False
Accept pipeline input:False
Accept wildcard characters: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 PowerShell 3.0.

Type:String
Accepted values:DCOM, WSMan
Position:Named
Default value:DCOM
Required:False
Accept pipeline input:False
Accept wildcard characters: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 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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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. La valeur par défaut est Default.

Les valeurs valides pour ce paramètre sont :

  • De base
  • CredSSP
  • Par défaut
  • Digest
  • Kerberos
  • Négocier.

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

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é lié à l'opération distante. Si l'ordinateur distant n'est pas fiable, les informations d'identification qui lui sont passées peuvent être utilisées pour contrôler la session réseau.

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

Type:String
Accepted values:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:Default
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

None

Par défaut, cette applet de commande ne retourne aucune sortie.

System.Management.Automation.RemotingJob

Lorsque vous utilisez le paramètre AsJob , cette applet de commande renvoie un objet RemotingJob .

Notes

Cette applet de commande utilise l’applet de commande Win32Shutdown méthode de la Win32_OperatingSystem classe WMI. Cette méthode nécessite que le SeShutdownPrivilege privilège soit activé pour le compte d’utilisateur utilisé pour arrêter l’ordinateur.