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>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Questo cmdlet è disponibile solo nella piattaforma Windows.

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

Questo cmdlet è stato introdotto in Windows PowerShell 3.0.

Esempio

Esempio 1: Rinominare il computer locale

Questo comando rinomina il computer locale in Server044 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 computer Srv01 in Server001. Il computer non viene riavviato.

Il parametro DomainCredential specifica le credenziali di un utente autorizzato a rinominare i computer nel dominio.

Il parametro Force elimina la richiesta di conferma.

$renameParams = @{
    ComputerName = "Srv01"
    NewName = "Server001"
    DomainCredential = "Domain01\Admin01"
    Force = $true
}
Rename-Computer @renameParams

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 sul remoting 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 autorizzato a connettersi al dominio. Le credenziali esplicite sono necessarie per rinominare un computer aggiunto a un dominio.

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

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

Per specificare un account utente autorizzato a connettersi al computer specificato dal parametro NomeComputer, 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 dell'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\User01oppure immettere un oggetto PSCredential, ad esempio quello generato dal cmdlet Get-Credential.

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), (A-Z), numeri (0-9) e trattini (-), ma non spazi o punti (.). 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, questo cmdlet non genera alcun output.

Tipo:SwitchParameter
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. Un riavvio è spesso necessario 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 cosa accadrebbe se il cmdlet viene eseguito. 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 accettabili per questo parametro sono:

  • Base
  • CredSSP
  • predefinito
  • Digest
  • Kerberos
  • Negoziare

Il valore predefinito è Default.

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

Avvertimento

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 di 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 del ComputerName e NewName proprietà 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.

Note

Questo cmdlet è disponibile solo nelle piattaforme Windows.