Delen via

Rename-Computer

Module:
Microsoft.PowerShell.Management Module

Wijzigt de naam van een computer.

Syntaxis

Default (Standaard) 

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 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.

$renameParams = @{
    ComputerName = "Srv01"
    NewName = "Server001"
    DomainCredential = "Domain01\Admin01"
    Force = $true
}
Rename-Computer @renameParams

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 PowerShell-remoteverbindingen. U kunt de parameter ComputerName van Rename-Computer gebruiken, zelfs als uw computer niet is geconfigureerd voor het uitvoeren van externe opdrachten.

Parametereigenschappen

Type:String
Default value:Local Computer
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:PSCredential
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:PSCredential
Default value:Current User
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-PassThru

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Restart

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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
  • Samenvatting
  • Kerberos
  • Onderhandelen

De standaardwaarde is Default.

Zie AuthenticationMechanism-opsommingvoor 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 op afstand uitgevoerde 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.

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

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

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

RenameComputerChangeInfo

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een RenameComputerChangeInfo--object.

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.