Condividi tramite

Rename-Computer

Modulo:
Microsoft.PowerShell.Management Module

Rinomina un computer.

Sintassi

Default (impostazione predefinita). 

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.

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

Proprietà dei parametri

Tipo:String
Valore predefinito:Local Computer
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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 o oppure immettere un oggetto PSCredential , ad esempio quello generato dal 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 NomeComputer, utilizzare il parametro LocalCredential.

Proprietà dei parametri

Tipo:PSCredential
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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 o oppure immettere un oggetto PSCredential , ad esempio quello generato dal 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.

Proprietà dei parametri

Tipo:PSCredential
Valore predefinito:Current User
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-PassThru

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Restart

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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:

  • Basico
  • CredSSP
  • Predefinita
  • Digerire
  • Kerberos
  • Negoziare

Il valore predefinito è Default.

Per ulteriori informazioni sui valori di questo parametro, consultare Enumerazione del Meccanismo di Autenticazione.

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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Valori accettati:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

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.