Rename-Computer

  • Referens
Modul:
Microsoft.PowerShell.Management

Byter namn på en dator.

Syntax

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

Description

Cmdleten Rename-Computer byter namn på den lokala datorn eller en fjärrdator. Den byter namn på en dator i varje kommando.

Den här cmdleten introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Byt namn på den lokala datorn

Det här kommandot byter namn på den lokala datorn till Server044 och startar sedan om den för att göra ändringen effektiv.

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

Exempel 2: Byt namn på en fjärrdator

Det här kommandot byter namn på Srv01 datorn till Server001. Datorn startas inte om.

Parametern DomainCredential anger autentiseringsuppgifterna för en användare som har behörighet att byta namn på datorer i domänen.

Parametern Force undertrycker bekräftelseprompten.

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

Parametrar

-ComputerName

Byter namn på den angivna fjärrdatorn. Standard är den lokala datorn.

Ange NetBIOS-namnet, en IP-adress eller ett fullständigt domännamn för en fjärrdator. Om du vill ange den lokala datorn skriver du datornamnet, en punkt (.) eller localhost.

Den här parametern förlitar sig inte på PowerShell-fjärrkommunikation. Du kan använda parametern Rename-Computer ComputerName för även om datorn inte är konfigurerad för att köra fjärrkommandon.

Typ:String
Position:Named
Standardvärde:Local Computer
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DomainCredential

Anger ett användarkonto som har behörighet att ansluta till domänen. Explicita autentiseringsuppgifter krävs för att byta namn på en dator som är ansluten till en domän.

Ange ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential-objekt , till exempel ett som genereras av cmdleten Get-Credential .

Om du skriver ett användarnamn uppmanas du att ange ett lösenord i den här cmdleten.

Om du vill ange ett användarkonto som har behörighet att ansluta till datorn som anges av parametern ComputerName använder du parametern LocalCredential .

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Tvingar kommandot att köras utan att be om användarbekräftelse.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LocalCredential

Anger ett användarkonto som har behörighet att ansluta till den dator som anges av parametern ComputerName . Standard är den aktuella användaren.

Ange ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential-objekt , till exempel ett som genereras av cmdleten Get-Credential .

Om du skriver ett användarnamn uppmanas du att ange ett lösenord i den här cmdleten.

Om du vill ange ett användarkonto som har behörighet att ansluta till domänen använder du parametern DomainCredential .

Typ:PSCredential
Position:Named
Standardvärde:Current User
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NewName

Anger ett nytt namn för datorn. Den här parametern krävs.

Standardnamn kan innehålla bokstäver (a-z), (A-Z), siffror (0-9) och bindestreck (-), men inga blanksteg eller punkter (.). Namnet får inte bestå helt av siffror och får inte vara längre än 63 tecken

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Returnerar resultatet av kommandot. Annars genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Protocol

Anger vilket protokoll som ska användas för att byta namn på datorn. De godtagbara värdena för den här parametern är: WSMan och DCOM. Standardvärdet är DCOM.

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:String
Godkända värden:DCOM, WSMan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Restart

Anger att den här cmdleten startar om datorn som har bytt namn. En omstart krävs ofta för att göra ändringen effektiv.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WsmanAuthentication

Anger den mekanism som används för att autentisera användarautentiseringsuppgifterna när den här cmdleten använder WSMan-protokollet. De acceptabla värdena för den här parametern är:

  • Grundläggande
  • CredSSP
  • Standardvärde
  • Smälta
  • Kerberos
  • Förhandla

Standardvärdet är Standard.

Mer information om värdena för den här parametern finns i AuthenticationMechanism Enumeration.

Varning

CredSSP-autentisering (CredSSP), där användarautentiseringsuppgifterna skickas till en fjärrdator som ska autentiseras, är utformad för kommandon som kräver autentisering på mer än en resurs, till exempel åtkomst till en fjärrnätverksresurs. Den här mekanismen ökar säkerhetsrisken för fjärråtgärden. Om fjärrdatorn komprometteras kan de autentiseringsuppgifter som skickas till den användas för att styra > nätverkssessionen.

Den här parametern introducerades i Windows PowerShell 3.0.

Typ:String
Godkända värden:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Den här cmdleten har inga parametrar som tar indata efter värde. Du kan dock skicka värdena för egenskaperna ComputerName och NewName för objekt till den här cmdleten.

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

RenameComputerChangeInfo

När du använder parametern PassThru returnerar den här cmdleten ett RenameComputerChangeInfo-objekt .