Condividi tramite

Rename-Computer

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Rinomina un computer.

Sintassi

Rename-Computer
      [-ComputerName <String>]
      [-PassThru]
      [-DomainCredential <PSCredential>]
      [-LocalCredential <PSCredential>]
      [-NewName] <String>
      [-Force]
      [-Restart]
      [-WsmanAuthentication <String>]
      [-Protocol <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il Rename-Computer cmdlet rinomina il computer locale o un computer remoto. Rinomina un computer in ogni comando.

Questo cmdlet è stato introdotto in Windows PowerShell 3.0.

Esempio

Esempio 1: Rinominare il computer locale

Questo comando rinomina il computer Server044 locale in e quindi lo riavvia per rendere effettiva la modifica.

Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart

Esempio 2: Rinominare un computer remoto

Questo comando rinomina il Srv01 computer in Server001. Il computer non viene riavviato.

Il parametro DomainCredential specifica le credenziali di un utente che dispone dell'autorizzazione per rinominare i computer nel dominio.

Il parametro Force elimina la richiesta di conferma.

Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force

Parametri

-ComputerName

Rinomina il computer remoto specificato. Il valore predefinito è il computer locale.

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 utilizzare il parametro ComputerName di Rename-Computer anche se il computer non è configurato per eseguire comandi remoti.

Tipo:String
Posizione:Named
Valore predefinito:Local Computer
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DomainCredential

Specifica un account utente che dispone dell'autorizzazione per la connessione al dominio. Per rinominare un computer aggiunto a un dominio, sono necessarie credenziali esplicite.

Digitare un nome utente, ad esempio User01 o Domain01\User01, o immettere un oggetto PSCredential , ad esempio quello generato dal Get-Credential cmdlet .

Se si digita un nome utente, questo cmdlet richiede una password.

Per specificare un account utente autorizzato a connettersi al computer specificato dal parametro ComputerName , utilizzare il parametro LocalCredential .

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

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-LocalCredential

Specifica un account utente autorizzato a connettersi al computer specificato dal parametro ComputerName . Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio User01 o Domain01\User01, o immettere un oggetto PSCredential , ad esempio quello generato dal Get-Credential cmdlet .

Se si digita un nome utente, questo cmdlet richiede una password.

Per specificare un account utente autorizzato a connettersi al dominio, usare il parametro DomainCredential .

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

-NewName

Specifica un nuovo nome per il computer. Questo parametro è obbligatorio.

I nomi standard possono contenere lettere (), (A-Z), numeri (0-9) e trattini (-), ma non spazi o punti (.).a-z Il nome potrebbe non essere costituito interamente da cifre e potrebbe non essere più lungo di 63 caratteri

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Restituisce i risultati del comando. In caso contrario, il cmdlet non genera alcun output.

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

-Protocol

Specifica il protocollo da utilizzare per rinominare il computer. I valori accettabili per questo parametro sono: WSMan e DCOM. Il valore predefinito è 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

-Restart

Indica che questo cmdlet riavvia il computer rinominato. Spesso è necessario un riavvio per rendere effettiva la modifica.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il 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 quando questo cmdlet usa il protocollo WSMan. I valori validi per questo parametro sono:

  • Base
  • CredSSP
  • Predefinita
  • Digerire
  • Kerberos
  • Negoziare

Il valore predefinito è Default.

Per altre informazioni sui valori di questo parametro, vedere AuthenticationMechanism Enumeration.

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 il computer remoto viene compromesso, è possibile usare le credenziali passate per controllare > la sessione di rete.

Questo parametro è stato introdotto in Windows PowerShell 3.0.

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

Input

None

Questo cmdlet non ha parametri che accettano input per valore. È tuttavia possibile inviare tramite pipe i valori delle proprietà ComputerName e NewName degli oggetti a questo cmdlet.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

RenameComputerChangeInfo

Quando si utilizza il parametro PassThru , questo cmdlet restituisce un oggetto RenameComputerChangeInfo .