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

Type:String
Position:Named
Default value:Local Computer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:PSCredential
Position:Named
Default value:Current User
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Restart

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

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 .

Note

Questo cmdlet è disponibile solo nelle piattaforme Windows.