Rename-Computer
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.
Type: | String |
Position: | Named |
Default value: | Local Computer |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Richiede la conferma dell'utente 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
, oppure immettere un oggetto PSCredential , ad esempio uno generato dal Get-Credential
cmdlet .
Se si digita un nome utente, questo cmdlet richiede una password.
Per specificare un account utente che dispone dell'autorizzazione per connettersi al computer specificato dal parametro ComputerName, usare 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: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalCredential
Specifica un account utente con l'autorizzazione per connettersi al computer specificato dal parametro ComputerName. Il valore predefinito è l'utente corrente.
Digitare un nome utente, ad esempio User01
o Domain01\User01
, oppure immettere un oggetto PSCredential , ad esempio uno generato dal Get-Credential
cmdlet .
Se si digita un nome utente, questo cmdlet richiede una password.
Per specificare un account utente che dispone dell'autorizzazione per 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 |
-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.
Type: | String |
Accepted values: | DCOM, WSMan |
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 l'esito in caso di 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
- Default
- Digest
- Kerberos
- Negotiate
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 in 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 dispone di parametri che accettano input per valore. È tuttavia possibile inviare tramite pipe i valori delle proprietà ComputerName e NewName degli oggetti a questo cmdlet.
Output
Questo cmdlet restituisce un oggetto ComputerChangeInfo , se si specifica il parametro PassThru . In caso contrario, non restituisce alcun output.