Delen via

Rename-Computer

  • Referentie
Module:
Microsoft.PowerShell.Management

Wijzigt de naam van een computer.

Syntaxis

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

Description

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 gewijzigd in Server044 en wordt deze 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 Forceren onderdrukt de bevestigingsprompt.

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

Parameters

-ComputerName

Wijzigt de naam van de opgegeven externe computer. De standaardwaarde is 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.

Deze parameter is niet afhankelijk van externe communicatie van PowerShell. U kunt de parameter ComputerName van Rename-Computer gebruiken, zelfs als uw computer niet is geconfigureerd voor het uitvoeren van externe opdrachten.

Type:String
Position:Named
Default value:Local Computer
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LocalCredential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is om verbinding te maken met de computer die is opgegeven door de ComputerName parameter. De standaardwaarde is 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.

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 het domein, gebruikt u de parameter DomainCredential.

Type:PSCredential
Position:Named
Default value:Current User
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NewName

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

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

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Protocol

Hiermee geeft u op welk protocol moet worden gebruikt om de naam van de computer te wijzigen. De acceptabele waarden voor deze parameter zijn: WSMan en DCOM. De standaardwaarde is DCOM.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:String
Geaccepteerde waarden:DCOM, WSMan
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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 acceptabele waarden voor deze parameter zijn:

  • Basic-
  • CredSSP-
  • standaard
  • Digest-
  • Kerberos-
  • onderhandelen over

De standaardwaarde is Default.

Zie Opsomming AuthenticationMechanismvoor 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 eraan worden doorgegeven, worden gebruikt om > de netwerksessie te beheren.

Deze parameter is geïntroduceerd in Windows PowerShell 3.0.

Type:String
Geaccepteerde waarden:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

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

Uitvoerwaarden

ComputerChangeInfo

Met deze cmdlet wordt een ComputerChangeInfo--object geretourneerd als u de parameter PassThru opgeeft. Anders retourneert deze geen uitvoer.