Restart-Computer

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Riavvia il sistema operativo nei computer locali e remoti.

Sintassi

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>]

Descrizione

Il Restart-Computer cmdlet riavvia il sistema operativo nei computer locali e remoti.

È possibile usare i parametri di per eseguire le operazioni di Restart-Computer riavvio come processo in background, per specificare i livelli di autenticazione e le credenziali alternative, limitare le operazioni eseguite contemporaneamente e forzare un riavvio immediato.

A partire da Windows PowerShell 3.0, è possibile attendere il completamento del riavvio prima di eseguire il comando successivo. Specificare un timeout di attesa e un intervallo di query e attendere che determinati servizi siano disponibili nel computer riavviato. Questa funzionalità rende pratico l'uso Restart-Computer in script e funzioni.

È possibile usare il protocollo WS-Management (WSMan) per riavviare il computer, nel caso in cui le chiamate DCOM (Distributed Component Object Model) siano bloccate, ad esempio da un firewall aziendale. Per altre informazioni, vedere WS-Management Protocol.

Questo cmdlet richiede la comunicazione remota di Windows PowerShell solo quando si usa il parametro AsJob in un comando.

Esempio

Esempio 1: Riavviare il computer locale

Restart-Computer riavvia il computer locale.

Restart-Computer

Esempio 2: Riavviare più computer

Restart-Computer può riavviare computer remoti e locali. Il parametro ComputerName accetta una matrice di nomi computer.

Restart-Computer -ComputerName Server01, Server02, localhost

Esempio 3: Riavviare i computer come processo in background

Questi comandi eseguono un Restart-Computer comando come processo in background in due computer remoti e quindi ottengono i risultati.

Poiché AsJob crea il processo nel computer locale e restituisce automaticamente i risultati al computer locale, è possibile eseguire Receive-Job come comando locale.

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

Restart-Computer utilizza il parametro ComputerName per specificare Server01 e Server02. Il parametro AsJob esegue il comando come processo in background. L'oggetto processo viene archiviato nella $Job variabile . $Job la pipeline viene inviata al Receive-Job cmdlet che ottiene i risultati.

Esempio 4: Riavviare un computer remoto

Restart-Computer riavvia un computer remoto con impostazioni di rappresentazione e autenticazione personalizzate.

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

Restart-Computer utilizza il parametro ComputerName per specificare Server01. Il parametro Impersonation specifica Anonymous per nascondere l'identità del richiedente. Il parametro DcomAuthentication specifica PacketIntegrity come livello di autenticazione della connessione.

Esempio 5: Forzare il riavvio dei computer elencati in un file di testo

In questo esempio viene forzato un riavvio immediato dei computer elencati nel Domain01.txt file. I nomi dei computer del file di testo vengono archiviati in una variabile. Il parametro Force forza un riavvio immediato e il parametro ThrottleLimit limita il numero di connessioni simultanee.

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

Get-Contentusa il parametro Path per ottenere un elenco di nomi di computer da un file di testo Domain01.txt. I nomi dei computer vengono archiviati nella variabile $Names. Get-Credential richiede un nome utente e una password e archivia i valori nella variabile $Creds. Restart-Computer usa i parametri ComputerName e Credential con le relative variabili. Il parametro Force causa un riavvio immediato di ogni computer. Il parametro ThrottleLimit limita il comando a 10 connessioni simultanee.

Esempio 6: Riavviare un computer remoto e attendere PowerShell

Restart-Computer riavvia il computer remoto e attende fino a 5 minuti (300 secondi) affinché PowerShell diventi disponibile nel computer riavviato prima che continui.

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

Restart-Computer utilizza il parametro ComputerName per specificare Server01. Il parametro Wait attende il completamento del riavvio. For specifica che PowerShell può eseguire comandi nel computer remoto. Il parametro Timeout specifica un'attesa di cinque minuti. Il parametro Delay esegue una query sul computer remoto ogni due secondi per determinare se viene riavviato.

Esempio 7: Riavviare un computer usando il protocollo WSMan

Restart-Computer riavvia il computer remoto usando il protocollo WSMan anziché il valore predefinito DCOM. L'autenticazione Kerberos determina se l'utente corrente dispone dell'autorizzazione per riavviare il computer remoto.

Queste impostazioni sono progettate per le aziende in cui i riavvii basati su DCOM hanno esito negativo perché DCOM è bloccato. Ad esempio, da un firewall.

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

Restart-Computerutilizza il parametro ComputerName per specificare il computer remoto Server01. Il parametro Protocol specifica di usare il protocollo WSMan. Il parametro WsmanAuthentication specifica il metodo di autenticazione come Kerberos.

Parametri

-AsJob

Indica che Restart-Computer viene eseguito come processo in background.

Per usare questo parametro, i computer locali e remoti devono essere configurati per la comunicazione remota. In Windows Vista e versioni successive del sistema operativo Windows è necessario aprire PowerShell usando l'opzione Esegui come amministratore . Per altre informazioni, vedere about_Remote_Requirements.

Quando si specifica il parametro AsJob , il comando restituisce immediatamente un oggetto che rappresenta il processo in background. È possibile continuare a lavorare nella sessione mentre il processo viene completato. Il processo viene creato nel computer locale e i risultati del computer remoto vengono automaticamente restituiti al computer locale. Per gestire il processo, usare i cmdlet job . Per ottenere i risultati del processo, usare il Receive-Job cmdlet .

Per altre informazioni sui processi in background di Windows PowerShell, vedere about_Jobs e about_Remote_Jobs.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ComputerName

Specifica un nome computer o una matrice delimitata da virgole di nomi computer. Restart-Computer accetta oggetti ComputerName dalla pipeline o dalle variabili.

Digitare il nome NetBIOS, un indirizzo IP o un nome di dominio completo di un computer remoto. Per specificare il computer locale, digitare il nome del computer, un punto .o localhost.

Questo parametro non si basa sulla comunicazione remota di PowerShell. È possibile usare il parametro ComputerName anche se il computer non è configurato per l'esecuzione di comandi remoti.

Se il parametro ComputerName non è specificato, Restart-Computer riavvia il computer locale.

Tipo:String[]
Alias:CN, __SERVER, Server, IPAddress
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire Restart-Computer.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Specifica un account utente autorizzato a eseguire questa azione. Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio User01 o Domain01\User01, oppure immettere un oggetto PSCredential generato dal Get-Credential cmdlet. Se si digita un nome utente, viene richiesto di immettere la password.

Le credenziali vengono archiviate in un oggetto PSCredential e la password viene archiviata come SecureString.

Nota

Per altre informazioni sulla protezione dei dati SecureString , vedere How secure is SecureString?.

Tipo:PSCredential
Posizione:1
Valore predefinito:Current user
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DcomAuthentication

Specifica il livello di autenticazione usato per la connessione WMI Restart-Computer usa WMI.

I valori validi sono:

  • Chiamata: Autenticazione COM a livello di chiamata
  • Connetti: autenticazione COM a livello di connessione
  • Impostazione predefinita: Autenticazione di Windows
  • Nessuno: nessuna autenticazione COM
  • Pacchetto: autenticazione COM a livello di pacchetto.
  • PacketIntegrity: autenticazione COM a livello di integrità dei pacchetti
  • PacketPrivacy: autenticazione COM a livello di privacy dei pacchetti.
  • Non modificato: il livello di autenticazione è uguale al comando precedente.

Per altre informazioni, vedere AuthenticationLevel Enumeration.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:AuthenticationLevel
Alias:Authentication
Valori accettati:Default, None, Connect, Call, Packet, PacketIntegrity, PacketPrivacy, Unchanged
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Delay

Specifica la frequenza delle query, in secondi. PowerShell esegue una query sul servizio specificato dal parametro For per determinare se il servizio è disponibile dopo il riavvio del computer.

Questo parametro è valido solo insieme ai parametri Wait e For .

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Se il parametro Delay non è specificato, Restart-Computer usa un ritardo di cinque secondi.

Tipo:Int16
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-For

Specifica il comportamento di PowerShell perché attende che il servizio o la funzionalità specificata diventino disponibili dopo il riavvio del computer. Questo parametro è valido solo con il parametro Wait .

I valori validi per questo parametro sono:

  • Impostazione predefinita: attende il riavvio di PowerShell.
  • PowerShell: può eseguire comandi in una sessione remota di PowerShell nel computer.
  • WMI: riceve una risposta a una query di Win32_ComputerSystem per il computer.
  • WinRM: può stabilire una sessione remota al computer usando WS-Management.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:WaitForServiceTypes
Valori accettati:Wmi, WinRM, PowerShell
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Forza un riavvio immediato del computer.

Tipo:SwitchParameter
Alias:f
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Impersonation

Specifica il livello di rappresentazione usato da questo cmdlet per chiamare WMI. Restart-Computer usa WMI. I valori validi per questo parametro sono:

  • Impostazione predefinita: rappresentazione predefinita. Nonostante il nome, questo non è il valore predefinito.
  • Anonimo: nasconde l'identità del chiamante.
  • Identificazione: consente agli oggetti di eseguire query sulle credenziali del chiamante.
  • Rappresentazione: consente agli oggetti di usare le credenziali del chiamante.
Tipo:ImpersonationLevel
Valori accettati:Default, Anonymous, Identify, Impersonate, Delegate
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Protocol

Specifica il protocollo da usare per riavviare i computer. I valori validi sono WSMan e DCOM.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:String
Valori accettati:DCOM, WSMan
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ThrottleLimit

Specifica il numero massimo di connessioni simultanee che è possibile stabilire per eseguire il comando. Questo valore limite si applica solo al comando corrente, non alla sessione o al computer.

Se il parametro ThrottleLimit non è specificato o viene usato un valore pari a 0, Restart-Computer usa un massimo di 32 connessioni simultanee.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Timeout

Specifica la durata dell'attesa, in secondi. Al termine del timeout, torna al prompt dei comandi, Restart-Computer anche se i computer non vengono riavviati.

Il parametro Timeout è valido solo con il parametro Wait . Il timeout esegue l'override del periodo di attesa indefinito del parametro Wait .

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:Int32
Alias:TimeoutSec
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Wait

Restart-Computer elimina il prompt di PowerShell e blocca la pipeline fino al riavvio dei computer. È possibile usare questo parametro in uno script per riavviare i computer e quindi continuare a elaborare al termine del riavvio.

Il parametro Wait attende a tempo indeterminato il riavvio dei computer. È possibile usare Timeout per regolare la tempistica e i parametri For e Delay per attendere che determinati servizi diventino disponibili nei computer riavviati.

Il parametro Wait non è valido quando si riavvia il computer locale. Se il valore del parametro ComputerName contiene i nomi dei computer remoti e del computer locale, Restart-Computer genera un errore non irreversibile per Wait sul computer locale, ma attende il riavvio dei computer remoti.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se l'esecuzione.Restart-Computer Il Restart-Computer cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WsmanAuthentication

Specifica il meccanismo utilizzato per autenticare le credenziali utente. Questo parametro è stato introdotto in Windows PowerShell 3.0.

I valori accettabili per questo parametro sono: Basic, CredSSP, Default, Digest, Kerberos e Negotiate.

Per altre informazioni, vedere AuthenticationMechanism.

Avviso

L'autenticazione CredSSP (Credential Security Service Provider), in cui le credenziali utente vengono passate a un computer remoto da autenticare, è progettato per i comandi che richiedono l'autenticazione su più di una risorsa, ad esempio l'accesso a una condivisione di rete remota. Questo meccanismo aumenta il rischio per la sicurezza dell'operazione remota. Se infatti il computer remoto viene compromesso, le credenziali che gli vengono passate possono essere usate per controllare la sessione di rete.

Tipo:String
Valori accettati:Basic, CredSSP, Default, Digest, Kerberos, Negotiate
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

È possibile inviare tramite pipe una stringa contenente un nome computer a questo cmdlet.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

System.Management.Automation.RemotingJob

Quando si usa il parametro AsJob , questo cmdlet restituisce un oggetto processo.

Note

  • Restart-Computer funziona solo su computer che eseguono Windows e richiede WinRM e WMI per arrestare un sistema, incluso il sistema locale.
  • Restart-Computer usa il metodo Win32Shutdown della classe wmi (Windows Management Instrumentation) Win32_OperatingSystem . Questo metodo richiede che il privilegio SeShutdownPrivilege sia abilitato per l'account utente usato per riavviare il computer.

In Windows PowerShell 2.0 il parametro AsJob non funziona in modo affidabile quando si riavviano o si arrestano i computer remoti. In Windows PowerShell 3.0 l'implementazione è stata modificata per risolvere il problema.