Stop-Computer
Arrête (arrête) les ordinateurs locaux et distants.
Syntaxe
All
Stop-Computer
[[-ComputerName] <String[]>]
[[-Credential] <PSCredential>]
[-WsmanAuthentication <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Stop-Computer arrête l’ordinateur local et les ordinateurs distants.
Vous pouvez utiliser les paramètres de Stop-Computer pour spécifier les niveaux d’authentification et les autres informations d’identification, et pour forcer l’arrêt immédiat.
Dans PowerShell 7.1, Stop-Computer a été ajouté pour Linux et macOS. Les plateformes autres que Windows ont uniquement les paramètres WhatIf, Confirm et CommonParameters . L’applet de commande appelle simplement la commande native /sbin/shutdown.
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.
L’opérateur en arrière-plan & exécute la commande Stop-Computer en tant que travail en arrière-plan. Pour plus d’informations, veuillez consulter la section about_Operators.
$j = Stop-Computer -ComputerName "Server01", "Server02" &
$results = $j | Receive-Job
$results
Stop-Computer utilise le paramètre ComputerName pour spécifier deux ordinateurs distants. L’opérateur d’arrière-plan & exécute la commande en tant que travail en arrière-plan. Les objets de travail sont stockés dans la variable $j.
Les objets de travail dans la variable $j 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 variable $results. La variable $results affiche les informations de travail dans la console PowerShell.
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" -WsmanAuthentication Kerberos
Stop-Computer utilise le paramètre ComputerName pour spécifier l’ordinateur distant. Le paramètre WsmanAuthentication spécifie d’utiliser Kerberos pour établir une connexion distante.
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 -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 variable $s.
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 variable $c.
Stop-Computer arrête les ordinateurs spécifiés avec la liste des ordinateurs de Nom_ordinateur de paramètres dans la variable $s. Le paramètre Forcer force un arrêt immédiat. Le paramètre Credential envoie les informations d’identification enregistrées dans la variable $c.
Paramètres
-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 repose pas sur la communication à distance de PowerShell. Vous pouvez utiliser le paramètre ComputerName même si votre ordinateur n’est pas configuré pour exécuter des commandes distantes.
Ce paramètre est disponible uniquement sur les plateformes Windows.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | CN, __SERVEUR, Serveur, adresse IP |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 de commande Get-Credential. 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 de SecureString, consultez Quelle est la sécurité de SecureString ?.
Ce paramètre est disponible uniquement sur les plateformes Windows.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | Current user |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Force
Force l’arrêt immédiat de l’ordinateur.
Ce paramètre est disponible uniquement sur les plateformes Windows.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 acceptables pour ce paramètre sont les suivantes :
- Élémentaire
- CredSSP
- Par défaut
- Résumé
- Kerberos
- Négocier.
Pour plus d’informations sur les valeurs de ce paramètre, consultez AuthenticationMechanism.
Avertissement
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 PowerShell 3.0. Ce paramètre est disponible uniquement sur les plateformes Windows.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | Default |
| Valeurs acceptées: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
None
Vous ne pouvez pas diriger les objets vers cette applet de commande.
Sorties
None
Cette applet de commande ne retourne aucune sortie.
Notes
Cette applet de commande utilise la méthode Win32Shutdown de la classe WMI Win32_OperatingSystem. Cette méthode nécessite que le privilège SeShutdownPrivilege soit activé pour le compte d’utilisateur utilisé pour arrêter l’ordinateur.
Dans PowerShell 7.1, Stop-Computer a été ajouté pour Linux et macOS. Pour ces plateformes, l’applet de commande appelle la commande native /sbin/shutdown.
