Restart-Computer

Syntaxe

Restart-Computer
       [-DcomAuthentication <AuthenticationLevel>]
       [-Impersonation <ImpersonationLevel>]
       [-WsmanAuthentication <String>]
       [-Protocol <String>]
       [[-ComputerName] <String[]>]
       [[-Credential] <PSCredential>]
       [-Force]
       [-Wait]
       [-Timeout <Int32>]
       [-For <WaitForServiceTypes>]
       [-Delay <Int16>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

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

Description

L’applet Restart-Computer de commande redémarre le système d’exploitation sur les ordinateurs locaux et distants.

Vous pouvez utiliser les paramètres de l’exécution des opérations de Restart-Computer redémarrage en tant que travail en arrière-plan, pour spécifier les niveaux d’authentification et les autres informations d’identification, pour limiter les opérations qui s’exécutent en même temps et forcer un redémarrage immédiat.

À compter de Windows PowerShell 3.0, vous pouvez attendre la fin du redémarrage avant d’exécuter la commande suivante. Spécifiez un délai d’attente et un intervalle de requête, puis attendez que des services particuliers soient disponibles sur l’ordinateur redémarré. Cette fonctionnalité rend pratique l’utilisation Restart-Computer dans les scripts et les fonctions.

Vous pouvez utiliser le protocole WS-Management (WSMan) pour redémarrer l’ordinateur, au cas où les appels DCOM (Distributed Component Object Model) sont bloqués, par exemple par un pare-feu d’entreprise. Pour plus d’informations, consultez WS-Management Protocol.

Cette applet de commande nécessite la communication à distance Windows PowerShell uniquement lorsque vous utilisez le paramètre AsJob dans une commande.

Exemples

Exemple 1 : Redémarrer l’ordinateur local

Restart-Computer redémarre l’ordinateur local.

Restart-Computer

Exemple 2 : Redémarrer plusieurs ordinateurs

Restart-Computer peut redémarrer des ordinateurs distants et locaux. Le paramètre ComputerName accepte un tableau de noms d’ordinateurs.

Restart-Computer -ComputerName Server01, Server02, localhost

Exemple 3 : Redémarrer les ordinateurs en tant que travail en arrière-plan

Ces commandes exécutent une Restart-Computer commande en tant que travail en arrière-plan sur deux ordinateurs distants, puis obtiennent les résultats.

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

$Job = Restart-Computer -ComputerName "Server01", "Server02" -AsJob
$Job | Receive-Job

Restart-Computer utilise le paramètre ComputerName pour spécifier Server01 et Server02. Le paramètre AsJob exécute la commande en tant que travail en arrière-plan. L’objet de travail est stocké dans la $Job variable. $Job est envoyé au pipeline vers l’applet Receive-Job de commande qui obtient les résultats.

Exemple 4 : Redémarrer un ordinateur distant

Restart-Computer redémarre un ordinateur distant avec des paramètres d’emprunt d’identité et d’authentification personnalisés.

Restart-Computer -ComputerName Server01 -Impersonation Anonymous -DcomAuthentication PacketIntegrity

Restart-Computer utilise le paramètre ComputerName pour spécifier Server01. Le paramètre Impersonation spécifie Anonymous pour masquer l’identité du demandeur. Le paramètre DcomAuthentication spécifie PacketIntegrity comme niveau d’authentification de la connexion.

Exemple 5 : Forcer le redémarrage des ordinateurs répertoriés dans un fichier texte

Cet exemple force un redémarrage immédiat des ordinateurs répertoriés dans le Domain01.txt fichier. Les noms d’ordinateurs du fichier texte sont stockés dans une variable. Le paramètre Force force un redémarrage immédiat et le paramètre ThrottleLimit limite le nombre de connexions simultanées.

$Names = Get-Content -Path C:\Domain01.txt
$Creds = Get-Credential
Restart-Computer -ComputerName $Names -Credential $Creds -Force -ThrottleLimit 10

Get-Content utilise le paramètre Path pour obtenir la liste des noms d’ordinateurs à partir d’un fichier texte, Domain01.txt. Les noms d’ordinateurs sont stockés dans la variable $Names. Get-Credential vous invite à entrer un nom d’utilisateur et un mot de passe et à stocker les valeurs dans la variable $Creds. Restart-Computer utilise les paramètres ComputerName et Credential avec leurs variables. Le paramètre Force provoque un redémarrage immédiat de chaque ordinateur. Le paramètre ThrottleLimit limite la commande à 10 connexions simultanées.

Exemple 6 : Redémarrer un ordinateur distant et attendre PowerShell

Restart-Computer redémarre l’ordinateur distant, puis attend jusqu’à 5 minutes (300 secondes) pour que PowerShell devienne disponible sur l’ordinateur redémarré avant de continuer.

Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2

Restart-Computer utilise le paramètre ComputerName pour spécifier Server01. Le paramètre Wait attend la fin du redémarrage. La commande For spécifie que PowerShell peut exécuter des commandes sur l’ordinateur distant. Le paramètre Timeout spécifie une attente de cinq minutes. Le paramètre Delay interroge l’ordinateur distant toutes les deux secondes pour déterminer s’il est redémarré.

Exemple 7 : Redémarrer un ordinateur à l’aide du protocole WSMan

Restart-Computer redémarre l’ordinateur distant à l’aide du protocole WSMan au lieu de la DCOM par défaut. L’authentification Kerberos détermine si l’utilisateur actuel est autorisé à redémarrer l’ordinateur distant.

Ces paramètres sont conçus pour les entreprises dans lesquelles les redémarrages basés sur DCOM échouent, car DCOM est bloqué. Par exemple, par un pare-feu.

Restart-Computer -ComputerName Server01 -Protocol WSMan -WsmanAuthentication Kerberos

Restart-Computer utilise le paramètre ComputerName pour spécifier l’ordinateur distant, Server01. Le paramètre protocole spécifie d’utiliser le protocole WSMan. Le paramètre WsmanAuthentication spécifie la méthode d’authentification en tant que Kerberos.

Paramètres

-AsJob

-ComputerName

-Confirm

-Credential

-DcomAuthentication

-Delay

-For

-Force

-Impersonation

-Protocol

-ThrottleLimit

-Timeout

-Wait

-WhatIf

-WsmanAuthentication

Entrées

String

Vous pouvez diriger une chaîne contenant un nom d’ordinateur 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 retourne un objet de travail.

Notes

• Restart-Computer Fonctionne uniquement sur les ordinateurs exécutant Windows et nécessite WinRM et WMI pour arrêter un système, y compris le système local.
• Restart-Computer utilise la méthode Win32Shutdown de la classe WMI (Windows Management Instrumentation) Win32_OperatingSystem . Cette méthode nécessite que le privilège SeShutdownPrivilege soit activé pour le compte d’utilisateur utilisé pour redémarrer l’ordinateur.

Dans Windows PowerShell 2.0, le paramètre AsJob ne fonctionne pas de manière fiable lorsque vous redémarrez ou arrêtez des ordinateurs distants. Dans Windows PowerShell 3.0, l'implémentation est modifiée pour résoudre ce problème.

Liens associés

• À propos de Windows Remote Management
• Get-Credential
• Protocole Gestion des services web