Rename-Computer

Byter namn på en dator.

Syntax

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

Description

Den här cmdleten är endast tillgänglig på Windows-plattformen.

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

Denna cmdlet 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-ComputerComputerName för även om datorn inte är konfigurerad för att köra fjärrkommandon.

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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 .

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

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 .

Type:PSCredential
Position:Named
Default value:Current User
Accept pipeline input:False
Accept wildcard characters: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

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

-PassThru

Returnerar resultatet av kommandot. Annars genererar denna cmdlet inga utdata.

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

-Restart

Anger att denna cmdlet startar om datorn som har bytt namn. En omstart krävs ofta för att ändringen ska börja gälla.

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

-WhatIf

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

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

-WsmanAuthentication

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

  • Basic
  • CredSSP
  • Standardvärde
  • Digest
  • 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 (Credential Security Service Provider), där användarens autentiseringsuppgifter 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.

Type:String
Accepted values:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Indata

None

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

Utdata

ComputerChangeInfo

Den här cmdleten returnerar ett ComputerChangeInfo-objekt om du anger parametern PassThru . Annars returneras inga utdata.

Kommentarer

Den här cmdleten är endast tillgänglig på Windows-plattformar.