Rename-Computer
Renomeia um computador.
Syntax
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Esse cmdlet só está disponível na plataforma Windows.
O Rename-Computer
cmdlet renomeia o computador local ou um computador remoto.
Ele renomeia um computador em cada comando.
Este cmdlet foi introduzido no Windows PowerShell 3.0.
Exemplos
Exemplo 1: Renomear o computador local
Esse comando renomeia o computador local para Server044
e o reinicia para tornar a alteração efetiva.
Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart
Exemplo 2: Renomear um computador remoto
Este comando renomeia o Srv01
computador para Server001
. O computador não é reiniciado.
O parâmetro DomainCredential especifica as credenciais de um usuário que tem permissão para renomear computadores no domínio.
O parâmetro Force suprime o prompt de confirmação.
Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force
Parâmetros
-ComputerName
Renomeia o computador remoto especificado. O padrão é o computador local.
Digite o nome NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado de um computador remoto.
Para especificar o computador local, digite o nome do computador, um ponto (.
) ou localhost
.
Esse parâmetro não depende da comunicação remota do PowerShell.
Você pode usar o parâmetro ComputerName de Rename-Computer
mesmo se o computador não estiver configurado para executar comandos remotos.
Type: | String |
Position: | Named |
Default value: | Local Computer |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainCredential
Especifica uma conta de usuário que tem permissão para se conectar ao domínio. São necessárias credenciais explícitas para renomear um computador que ingressou em um domínio.
Digite um nome de usuário, como User01
ou Domain01\User01
, ou insira um objeto PSCredential , como um gerado pelo Get-Credential
cmdlet.
Se você digitar um nome de usuário, esse cmdlet solicitará uma senha.
Para especificar uma conta de usuário que tenha permissão para se conectar ao computador especificado pelo parâmetro ComputerName , use o parâmetro LocalCredential .
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalCredential
Especifica uma conta de usuário que tem permissão para se conectar ao computador especificado pelo parâmetro ComputerName . O padrão é o usuário atual.
Digite um nome de usuário, como User01
ou Domain01\User01
, ou insira um objeto PSCredential , como um gerado pelo Get-Credential
cmdlet.
Se você digitar um nome de usuário, esse cmdlet solicitará uma senha.
Para especificar uma conta de usuário que tenha permissão para se conectar ao domínio, use o parâmetro DomainCredential .
Type: | PSCredential |
Position: | Named |
Default value: | Current User |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Especifica um novo nome para o computador. Este parâmetro é obrigatório.
Os nomes padrão podem conter letras (), (A-Z
), números (0-9
) e hífens (-
), mas sem espaços ou pontos (.
).a-z
O nome não pode consistir inteiramente de dígitos e não pode ter mais de 63 caracteres
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Retorna os resultados do comando. Caso contrário, este cmdlet não gera nenhuma saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Restart
Indica que esse cmdlet reinicia o computador que foi renomeado. Uma reinicialização é geralmente necessária para que as alterações entrem em vigor.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WsmanAuthentication
Especifica o mecanismo usado para autenticar as credenciais do usuário quando esse cmdlet usa o protocolo WSMan. Os valores aceitáveis para esse parâmetro são:
- Basic
- CredSSP
- Default
- Digest
- Kerberos
- Negociar
O valor padrão é Default.
Para obter mais informações sobre os valores desse parâmetro, consulte AuthenticationMechanism Enumeration.
Aviso
A autenticação CredSSP (Credential Security Service Provider), na qual as credenciais do usuário são passadas para um computador remoto para serem autenticadas, foi projetada para comandos que exigem autenticação em mais de um recurso, como acessar um compartilhamento de rede remoto. Esse mecanismo aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, as credenciais que são passadas para ele podem ser usadas para controlar > a sessão de rede.
Este parâmetro foi introduzido no Windows PowerShell 3.0.
Type: | String |
Accepted values: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Esse cmdlet não tem parâmetros que recebem entrada por valor. No entanto, você pode canalizar os valores das propriedades ComputerName e NewName dos objetos para esse cmdlet.
Saídas
None
Por padrão, esse cmdlet não retorna nenhuma saída.
Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto RenameComputerChangeInfo .
Observações
Esse cmdlet só está disponível em plataformas Windows.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de