Redémarre le système d’exploitation sur les ordinateurs locaux et distants.
- Syntaxe
- Description
- Exemples
- Exemple 1 : Redémarrez l’ordinateur local
- Exemple 2: Redémarrez plusieurs ordinateurs
- Exemple 3: Obtenir les noms d’ordinateurs à partir d’un fichier texte
- Exemple 4 : Forcer le redémarrage des ordinateurs répertoriés dans un fichier texte
- Exemple 6 : Redémarrez un ordinateur distant et attendez que PowerShell
- Exemple 7 : Redémarrez un ordinateur à l’aide de WsmanAuthentication
- Parameters
- Inputs
- Outputs
- Notes
Syntaxe
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, pour spécifier les niveaux d’authentification et les informations d’identification alternatives, pour limiter les opérations qui s’exécutent en même temps et pour forcer un redémarrage immédiat.
À partir 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, et attendez que des services particuliers soient disponibles sur l’ordinateur redémarré. Cette fonctionnalité rend pratique l’utilisation d’inscriptions et de fonctions Restart-Computer.
Exemples
Exemple 1 : Redémarrez l’ordinateur local
Restart-Computer redémarre l’ordinateur local.
Restart-ComputerExemple 2: Redémarrez plusieurs ordinateurs
Restart-Computer peut redémarrer des ordinateurs distants et locaux. Le paramètre ComputerName accepte un ensemble de noms d’ordinateurs.
Restart-Computer -ComputerName Server01, Server02, localhostExemple 3: Obtenir les noms d’ordinateurs à partir d’un fichier texte
Restart-Computer obtient une liste de noms d’ordinateurs à partir d’un fichier texte et redémarre les ordinateurs. Le paramètre Computername n’est pas spécifié. Mais parce que c’est le premier paramètre de position, ilaccepte les noms d’ordinateur du fichier texte qui sont envoyés dans le pipeline.
Get-Content -Path C:\Domain01.txt | Restart-ComputerGet-Content utilise le paramètre Path pour obtenir une liste de noms d’ordinateurs à partir d’un fichier texte, Domain01.txt. Les noms d’ordinateurs sont envoyés dans le pipeline. Restart-Computer redémarre chaque ordinateur.
Exemple 4 : 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 fichier Domain01.txt. Les noms d’ordinateurs du fichier texte sont stockés dans une variable. Le paramètre Force force le redémarrage d’animmediate.
Get-Content utilise le paramètre Path pour obtenir une liste de noms d’ordinateurs à partir d’un fichier texte, Domain01.txt. Les noms d’ordinateurs sont stockés dans la variable $NamesGet-Credential vous invite à entrer un nom d’utilisateur et un mot de passe et stocke les valeurs dans la variable $CredsRestart-Computer utilise les paramètres ComputerName et Credential avec leurs variables. Le Forceparameter provoque un redémarrage immédiat de chaque ordinateur.
Exemple 6 : Redémarrez un ordinateur distant et attendez que PowerShell
Restart-Computer redémarre l’ordinateur distant, puis attend jusqu’à 5 minutes (300 secondes) que PowerShell devienne disponible sur l’ordinateur redémarré avant qu’il ne continue.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2Restart-Computer utilise le paramètre ComputerName pour spécifier Server01. Le paramètre Waitparameter attend la fin du redémarrage. Le 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 vérifie l’ordinateur distant toutes les deux secondes pour déterminer s’il est redémarré.
Exemple 7 : Redémarrez un ordinateur à l’aide de WsmanAuthentication
Restart-Computer redémarre l’ordinateur distant à l’aide du mécanisme WsmanAuthentication.L’authentification Kerberos détermine si l’utilisateur actuel est autorisé à redémarrer l’ordinateur distant. Pour plus d’informations, Voirauthenticationmechanism.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-Computer utilise le paramètre ComputerName pour spécifier l’ordinateur distant, Server01.Le paramètre WsmanAuthentication spécifie la méthode d’authentification en tant que Kerberos.
Parameters
Spécifie un nom d’ordinateur ou un tableau de noms d’ordinateur séparés par des virgules. Restart-Computer Accepte les objets Computername du pipeline ou des variables.
Saisissez 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 repose pas sur la télécommande PowerShell. Vous pouvez utiliser le paramètre ComputerName même si votre ordinateur n’est pas configuré pour exécuter des commandes distantes.
Si le paramètre ComputerName n’est pas spécifié, Restart-Computer redémarre l’ordinateur local.
| Type: | Chaîne |
| Alias: | CN, __ SERVEUR, serveur, adresse IP |
| Position: | 0 |
| Valeur par défaut: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Prompts you for confirmation before running Restart-Computer.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Spécifie un compte 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 PSCredentialobject et le mot de passe est stocké sous forme de SecureString.
Note
For more information about SecureString data protection, seeHow secure is SecureString?.
| Type: | PSCredential |
| Position: | 1 |
| Default value: | Current user |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the frequency of queries, in seconds. PowerShell interroge le service spécifié par le paramètre theFor pour déterminer si le service est disponible après le redémarrage de l’ordinateur.
Ce paramètre n’est valide qu’avec les paramètres Wait and For.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
Si le paramètre Delay n’est pas spécifié, Restart-Computer utilise un délai de cinq secondes.
| Type: | Int16 |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Accepter l’entrée du pipeline: | False |
| Accepte les caractères génériques : | False |
Spécifie le comportement de PowerShell en attendant que le service ou la fonctionnalité spécifié devienne disponible après le redémarrage de l’ordinateur. Ce paramètre n’est valide qu’avec le paramètre Wait.
Les valeurs acceptables pour ce paramètre sont :
- Par défaut : Attend le redémarrage de PowerShell.
- PowerShell: Peut exécuter des commandes dans une session distante PowerShell sur l’ordinateur.
- WMI: Reçoit une réponse à une requête Win32_ComputerSystem pour l’ordinateur.
- WinRM : Permet d’établir une session distante sur l’ordinateur en utilisant WS-Management.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | WaitForServiceTypes |
| Valeurs acceptées: | Wmi, WinRM, PowerShell |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Accepter l’entrée du pipeline: | False |
| Accepter les caractères génériques: | False |
Forces an immediate restart of the computer.
| Type: | SwitchParameter |
| Aliases: | f |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Specifies the duration of the wait, in seconds. Lorsque le délai d’expiration est écoulé, Restart-Computer retourne à l’invite de commande, même si les ordinateurs ne sont pas redémarrés.
Le paramètre Timeout n’est valide qu’avec le paramètre Wait. Timeout remplace la période d’attente indéfinie du paramètre Wait.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | Int32 |
| Alias: | TimeoutSec |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Accepter l’entrée du pipeline: | False |
| Accepte les caractères génériques : | False |
Restart-Computer supprime l’invite PowerShell et bloque le pipeline jusqu’à ce que les ordinateurs j’ai commencé. Vous pouvez utiliser ce paramètre dans un script pour redémarrer des ordinateurs, puis continuer à traiter lorsque le redémarrage est terminé.
Le paramètre Wait attend indéfiniment le redémarrage des ordinateurs. Vous pouvez utiliser Timeout pour ajuster le timing et les paramètres For et Delay pour attendre que des services particuliers deviennent disponibles sur les ordinateurs redémarrés.
Le paramètre Wait n’est pas valide lorsque vous redémarrez l’ordinateur local. Si la valeur du paramètre Computername contient les noms des ordinateurs distants et de l’ordinateur local, Restart-Computer génère une erreur de non-terminaison pour l’attente sur l’ordinateur local, mais attend que les ordinateurs distants redémarrent.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Shows what would happen if the Restart-Computer runs. The Restart-Computer cmdlet isn’t run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Nommé |
| Valeur par défaut: | False |
| Accepter l’entrée du pipeline: | False |
| Accepter les caractères génériques: | False |
Spécifie le mécanisme utilisé pour authentifier les informations d’identification de l’utilisateur. Ce paramètre a été introduit dans Windows PowerShell 3.0.
Les valeurs acceptables pour ce paramètre sont : Basic, CredSSP, Default, Digest, Kerberos et Negotiate.
Pour plus d’informations, Voirauthenticationmechanism.
Avertissement
L’authentification du fournisseur de services de sécurité des informations d’identification (CredSSP), dans laquelle les informations d’identification de l’utilisateur sont transmises à un ordinateur distant pour être authentifiées, est conçue pour les commandes nécessitant une authentification sur plusieurs ressources, telles que l’accès à un partage réseau distant. Ce mécanismeaugmente le risque de sécurité de l’opération à distance. Si l’ordinateur distant est compromis, les crédits qui lui sont transmis peuvent être utilisés pour contrôler la session réseau.
| Type: | Chaîne |
| Valeurs acceptées: | Basic, CredSSP, Default, Digest, Kerberos, Negotiate |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
String
Restart-Computer accepts computer names from the pipeline or variables.
Outputs
None
Restart-Computer doesn’t generate any output.
Notes
- Sous Windows,
Restart-Computerutilise la méthode Win32Shutdown de la classe Win32_operatingsystem d’Instrumentation de gestion Windows (WMI). Cette méthode nécessite que le privilège SeShutdownPrivilege soit activé pour que le compte d’utilisateur utilisé redémarre la machine. - Sous Linux et Mac OS,
Restart-Computerutilise l’outil bash/sbin/shutdown.
- À propos de la gestion à distance Windows
- Get-Credential
- Protocole de gestion WS