Redémarre le système d'exploitation sur les ordinateurs locaux et distants.
Syntaxe
Restart-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 Restart-Computer redémarre le système d'exploitation sur les ordinateurs locaux et distants.
Vous pouvez utiliser les paramètres de Restart-Computer pour exécuter les opérations de redémarrage en tant que tâche en arrière-plan, spécifier les niveaux d'authentification et d'autres informations d'identification, limiter les opérations qui s'exécutent simultanément et forcer un redémarrage 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 (Restart-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[]>
Spécifie un ou plusieurs ordinateurs distants. La valeur par défaut est l'ordinateur local.
Tapez le nom NETBIOS, une adresse IP ou un nom de domaine complet d'un ordinateur distant. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, un point (.) 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 le redémarrage 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 (Restart-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. 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>restart-computer Description ----------- Cette commande redémarre l'ordinateur local.
Exemple 2
C:\PS>restart-computer -computername Server01, Server02, localhost Description ----------- Cette commande redémarre deux ordinateurs distants (Server01 et Server02) et l'ordinateur local (identifié par « localhost »).
Exemple 3
C:\PS>$j = restart-computer -computername Server01, Server02 -asjob C:\PS> $results = $j | receive-job C:\PS> $results Description ----------- Ces commandes exécutent une commande Restart-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>restart-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> restart-computer -computername $s -force -throttlelimit 10 -credential $c Description ----------- Ces commandes forcent le redémarrage immédiat de tous les ordinateurs figurant 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 redémarre 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 redémarrage 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