Share via

Rename-Computer

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee wijzigt u 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 in elke opdracht wordt gewijzigd.

Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.

Voorbeelden

Voorbeeld 1: de naam van de lokale computer wijzigen

Met deze opdracht wijzigt u de naam van de lokale computer in Server044 en start deze opnieuw op om de wijziging van kracht te laten worden.

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.

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

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

-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 is gemachtigd om verbinding te maken met het domein. Expliciete referenties zijn vereist voor het wijzigen van de naam van een computer die lid is van een domein.

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

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

Als u een gebruikersaccount wilt opgeven dat is gemachtigd 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 om bevestiging van de gebruiker te vragen.

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 is gemachtigd om verbinding te maken met de computer die is opgegeven met 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 wordt gegenereerd door de Get-Credential cmdlet.

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

Als u een gebruikersaccount wilt opgeven dat is gemachtigd om verbinding te maken met het domein, gebruikt u de parameter DomainCredential .

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

-NewName

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

Standaardnamen mogen 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
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 computer opnieuw wordt opgestart waarvoor de naam is gewijzigd. Een herstart is vaak vereist om de wijziging van kracht te laten worden.

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
  • Samenvatting
  • 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 om te 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 gecompromitteerd, 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 op waarde nemen. U kunt echter de waarden van de eigenschappen ComputerName en NewName van objecten doorsnijden naar deze cmdlet.

Uitvoerwaarden

ComputerChangeInfo

Deze cmdlet retourneert een ComputerChangeInfo-object , als u de parameter PassThru opgeeft. Anders wordt er geen uitvoer geretourneerd.

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.