reinicializa o sistema operacional em computadores locais e remotos.
- Sintaxe
- Descrição
- Exemplos
- Exemplo 1: Reiniciar o computador local
- Exemplo 2: Reiniciar vários computadores
- Exemplo 3: Obter nomes de computador a partir de um arquivo de texto
- exemplo 4: reinício da força de computadores listados num ficheiro de texto
- exemplo 6: reiniciar um computador remoto e esperar por PowerShell
- Exemplo 7: Reiniciar um computador usando WsmanAuthentication
- Parameters
- Inputs
- Outputs
- Notes
Sintaxe
Descrição
Restart-Computer cmdlet reinicia o sistema operacional em computadores locais e remotos.
Você pode usar os parâmetros de Restart-Computer para executar o reinício de operações, para especificar theauthentication níveis e credenciais alternativas, para limitar as operações que execute, ao mesmo tempo,e para forçar uma imediata reiniciar.
começando no Windows PowerShell 3. 0, você pode esperar que o reinício termine antes de executar o nextcommand. Especifique um intervalo de tempo de espera e de consulta, e aguarde que determinados Serviços estejam disponíveis no computador reiniciado. Esta característica torna prático o uso deRestart-Computer inscrições e funções.
Exemplos
Exemplo 1: Reiniciar o computador local
Restart-Computer reinicia o computador local.
Restart-ComputerExemplo 2: Reiniciar vários computadores
Restart-Computer pode reiniciar computadores locais e remotos. O parâmetro ComputerName aceita uma série de nomes de computador.
Restart-Computer -ComputerName Server01, Server02, localhostExemplo 3: Obter nomes de computador a partir de um arquivo de texto
Restart-Computer obtém uma lista de nomes de computador a partir de um arquivo de texto e reiniciar os computadores. O parâmetro nome completo não está especificado. Mas como é o parâmetro da primeira posição, descreve os nomes dos computadores do arquivo de texto que são enviados pelo oleoduto.
Get-Content -Path C:\Domain01.txt | Restart-ComputerGet-Content usa o parâmetro Path para obter uma lista de nomes de computador a partir de um arquivo de texto,Domain01.txt. Os nomes dos computadores são enviados pelo oleoduto. Restart-Computer restarts eachcomputer.
exemplo 4: reinício da força de computadores listados num ficheiro de texto
este exemplo força um reinício imediato dos computadores listados no ficheiro Domain01.txt. Os nomes do computador do ficheiro de texto são armazenados numa variável. O parâmetro de força obriga a reiniciar o processo.
Get-Content usa o parâmetro Path para obter uma lista de nomes de computador de um arquivo de texto,Domain01.txt. Os nomes dos computadores são armazenados na variável $NamesGet-Credential promptsyou for a username and password and stores the values in the variable$CredsRestart-Computerusa os parâmetros computacionais e credenciais com suas variáveis. O Forceparameter causa um recomeço imediato de cada computador.
exemplo 6: reiniciar um computador remoto e esperar por PowerShell
Restart-Computer reiniciar o computador remoto e, em seguida, espera até 5 minutos (300 segundos) para que o PowerShell fique disponível no computador reiniciado antes de continuar.
Restart-Computer -ComputerName Server01 -Wait -For PowerShell -Timeout 300 -Delay 2Restart-Computer usa o parâmetro ComputerName para especificar Server01. O Waitparameter espera que o reinício termine. O For especifica que o PowerShell pode executar comandos no computador remoto. O parâmetro tempo-limite indica uma espera de cinco minutos. O Delay parameterqueries the remote computer every two seconds to determine whether it’s restarted.
Exemplo 7: Reiniciar um computador usando WsmanAuthentication
Restart-Computer reinicia o computador remoto usando o WsmanAuthentication mecanismo.A autenticação do Kerberos determina se o utilizador actual tem permissão para reiniciar o computador remoto. Para obter mais informações, consulte o mecanismo de integração.
Restart-Computer -ComputerName Server01 -WsmanAuthentication KerberosRestart-Computer usa o parâmetro ComputerName para especificar o computador remoto Server01.O parâmetro wsmanauthentication especifica o método de autenticação como Kerberos.
Parameters
especifica um nome de computador ou uma matriz separada por vírgulas de nomes de computadores. Restart-Computer acceptsComputerName objects from the pipeline or variables.
digite o nome NetBIOS, um endereço IP, ou um nome de domínio totalmente qualificado de um computador remoto. Tospecify the local computer, type the computer name, a dot ., or localhost.
Este parâmetro não depende da PowerShell remoting. Você pode usar o parâmetro ComputerName mesmo se o seu computador não estiver configurado para executar comandos remotos.
Se o parâmetro do computador não for especificado, Restart-Computer reinicializa o computador local.
| Tipo: | String |
| Aliases: | CN, __, o SERVIDOR, o Endereço ip |
| Posição: | 0 |
| valor Padrão: | 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 |
Especifica uma conta de usuário que tem permissão para efectuar esta acção. O padrão é o usuário atual.
Type a User01, such as User01 or Domain01\User01, or enter a PSCredential objectgenerated by the Get-Credential cmdlet. Se escrever um nome de Utilizador, é-lhe pedido que introduza a palavra passe.
As credenciais são armazenadas em um PSCredentialobject e a senha é armazenada como um 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 questiona o serviço especificado pelo parâmetro theFor para determinar se o serviço está disponível após o computador ser reiniciado.
Este parâmetro é válido apenas em conjunto com a espera e para os parâmetros.
Este parâmetro foi introduzido no Windows PowerShell 3.0.
Se o parâmetro de atraso não for especificado, Restart-Computer utiliza um atraso de cinco segundos.
| Tipo: | Int16 |
| Cargo: | Nome |
| valor Padrão: | None |
| Aceita a entrada de pipeline: | False |
| Aceita caracteres curinga: | False |
Especifica o comportamento do PowerShell como ele espera que o serviço ou recurso para becomeavailable depois que o computador for reiniciado. Este parâmetro só é válido com o parâmetro de espera.
os valores aceitáveis para este parâmetro são:
- Por omissão: espera que o PowerShell reinicie.
- PowerShell: pode executar comandos numa sessão remota PowerShell no computador.WMI: Recebe uma resposta a uma consulta Win32_ComputerSystem para o computador.
- WinRM: pode estabelecer uma sessão remota para o computador usando WS-Management.
Este parâmetro foi introduzido no Windows PowerShell 3.0.
| Tipo: | WaitForServiceTypes |
| valores Aceitos: | Wmi, o WinRM, o PowerShell |
| Posição: | Nome |
| valor Padrão: | None |
| Aceita a entrada de pipeline: | False |
| Aceita caracteres curinga: | 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. Quando o tempo-limite decair, Restart-Computer retornará à linha de comandos, mesmo que os computadores não sejam reiniciados.
O parâmetro de Tempo-Limite só é válido com o parâmetro de espera. O tempo-limite sobrepõe-se ao período de espera indefinido do parâmetro de espera.
Este parâmetro foi introduzido no Windows PowerShell 3.0.
| Tipo: | Int32 |
| Aliases: | TimeoutSec |
| Cargo: | Nome |
| valor Padrão: | None |
| Aceita a entrada de pipeline: | False |
| Aceita caracteres curinga: | False |
Restart-Computer suprime o prompt do PowerShell e bloqueia o pipeline até que os computadores haverestarted. Você pode usar este parâmetro em um script para reiniciar computadores e, em seguida, continuar a processar quando o reinício é terminado.
O parâmetro espera indefinidamente que os computadores reiniciem. Você pode usar o tempo-limite para ajustar o timing e os parâmetros de For e Delay para esperar que serviços específicos se tornem disponíveis nos computadores reiniciados.
O parâmetro de espera não é válido quando você está reiniciando o computador local. Se o valor do parâmetro ComputerName contiver os nomes dos computadores remotos e do computador local,Restart-Computer gera um erro de não-terminação para esperar no computador local, mas espera que os computadores remotos reiniciem.
Este parâmetro foi introduzido no Windows PowerShell 3.0.
| Tipo: | 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: | Nome |
| valor Padrão: | False |
| Aceita a entrada de pipeline: | False |
| Aceita caracteres curinga: | False |
Especifica o mecanismo que é usado para autenticar as credenciais do usuário. Este parâmetro foi introduzido no Windows PowerShell 3.0.
os valores aceitáveis para este parâmetro são: Basic, CredSSP, Default,Digest, Kerberos, and Negocy.
para mais informações, consulte um mecanismo de estimulação.
Aviso
Credential Security Service Provider (CredSSP) de autenticação, em que as credenciais do usuário arepassed a um computador remoto para ser autenticado, é projetado para comandos que requireauthentication em mais do que um recurso, tal como aceder a uma partilha de rede remota. Este mecanismo aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, os créditos que são passados a ele podem ser usados para controlar a sessão de rede.
| Tipo: | String |
| valores Aceitos: | 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
- In Windows,
Restart-Computeruses the Win32Shutdown method of the Windows Management Instrumentation (WMI) Win32_OperatingSystemclass. Este método requer que o privilégio SeShutdownPrivilege esteja activo para que a conta de utilizador utilizada reinicie a máquina. - On Linux and Mac OS,
Restart-Computerusa a ferramenta/sbin/shutdownbash.
- acerca do Windows Remote Management
- Get-Credential
- WS-Management Protocol