Rename-Computer (Microsoft.PowerShell.Management)

Referentie

Module:: Microsoft.PowerShell.Management

Wijzigt de naam van een computer.

Syntax

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

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Rename-Computer cmdlet wijzigt de naam van de lokale computer of een externe computer.De naam van één computer wordt in elke opdracht gewijzigd.

Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.

Voorbeelden

Voorbeeld 1: De naam van de lokale computer wijzigen

Met deze opdracht wordt de naam van de lokale computer Server044 gewijzigd en vervolgens opnieuw opgestart om de wijziging effectief te maken.

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

Voorbeeld 2: De naam van een externe computer wijzigen

Met deze opdracht wordt de naam van de Srv01 computer gewijzigd in Server001. De computer is niet opnieuw opgestart.

De parameter DomainCredential geeft de referenties op van een gebruiker die gemachtigd is om de naam van computers in het domein te wijzigen.

De parameter Force onderdrukt de bevestigingsprompt.

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

Parameters

-ComputerName

Wijzigt de naam van de opgegeven externe computer.Standaard is dit de lokale computer.

Typ de NetBIOS-naam, een IP-adres of een volledig gekwalificeerde domeinnaam van een externe computer.Als u de lokale computer wilt opgeven, typt u de computernaam, een punt (.) of localhost.

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-DomainCredential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om verbinding te maken met het domein.Expliciete referenties zijn vereist om de naam van een computer te wijzigen die is gekoppeld aan een domein.

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in, zoals een object dat is gegenereerd door de Get-Credential cmdlet.

Als u een gebruikersnaam typt, wordt u door deze cmdlet gevraagd om een wachtwoord.

Als u een gebruikersaccount wilt opgeven dat gemachtigd is om verbinding te maken met de computer die is opgegeven door de parameter ComputerName , gebruikt u de parameter LocalCredential .

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

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

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

-LocalCredential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om verbinding te maken met de computer die is opgegeven door de parameter ComputerName . Standaard is dit de huidige gebruiker.

Typ een gebruikersnaam, zoals User01 of Domain01\User01, of voer een PSCredential-object in, zoals een object dat is gegenereerd door de Get-Credential cmdlet.

-NewName

Hiermee geeft u een nieuwe naam voor de computer.Deze parameter is vereist.

Standaardnamen mogen letters (), (A-Z), cijfers (0-9) en afbreekstreepjes (-) bevatten, maar geen spaties of punten (.).a-z De naam mag niet volledig uit cijfers bestaan en mag niet langer zijn dan 63 tekens

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

-PassThru

Retourneert de resultaten van de opdracht.Anders genereert deze cmdlet geen uitvoer.

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

-Restart

Geeft aan dat met deze cmdlet de naam van de computer opnieuw wordt opgestart.Een herstart is vaak vereist om de wijziging effectief te maken.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert.De cmdlet wordt niet uitgevoerd.

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

-WsmanAuthentication

Hiermee geeft u het mechanisme op dat wordt gebruikt om de gebruikersreferenties te verifiëren wanneer deze cmdlet het WSMan-protocol gebruikt. De aanvaardbare waarden voor deze parameter zijn:

Basic
CredSSP
Standaard
Digest
Kerberos
Onderhandelen

De standaardwaarde is Standaard.

Zie AuthenticationMechanism Enumeration voor meer informatie over de waarden van deze parameter.

Waarschuwing

CredSSP-verificatie (Credential Security Service Provider), waarbij de gebruikersreferenties worden doorgegeven aan een externe computer die moet worden geverifieerd, is ontworpen voor opdrachten waarvoor verificatie is vereist voor meer dan één resource, zoals toegang tot een externe netwerkshare.Dit mechanisme verhoogt het beveiligingsrisico van de externe bewerking.Als de externe computer is aangetast, kunnen de referenties die aan de computer worden doorgegeven, worden gebruikt om de netwerksessie te beheren > .

Deze parameter is geïntroduceerd 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

Invoerwaarden

None

Deze cmdlet heeft geen parameters die invoer per waarde aannemen. U kunt echter de waarden van de eigenschappen ComputerName en NewName van objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden