Rename-Computer
Byter namn på en dator.
Syntax
Default (Standard)
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.
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å den 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äftelsemeddelandet.
$renameParams = @{
ComputerName = "Srv01"
NewName = "Server001"
DomainCredential = "Domain01\Admin01"
Force = $true
}
Rename-Computer @renameParams
Parametrar
-ComputerName
Byter namn på den angivna fjärrdatorn. Standardvärdet ä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 ComputerName för Rename-Computer även om datorn inte är konfigurerad för att köra fjärrkommandon.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | Local Computer |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | jfr |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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 Get-Credential cmdlet.
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.
Parameteregenskaper
| Typ: | PSCredential |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Force
Tvingar kommandot att köras utan att be om användarbekräftelse.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-LocalCredential
Anger ett användarkonto som har behörighet att ansluta till den dator som anges av parametern ComputerName. Standardvärdet ä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 Get-Credential cmdlet.
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.
Parameteregenskaper
| Typ: | PSCredential |
| Standardvärde: | Current User |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-PassThru
Returnerar resultatet av kommandot. Annars genererar den här cmdleten inga utdata.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Wi |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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 godtagbara värdena för den här parametern är:
- Grundläggande
- CredSSP
- Standardinställning
- Sammanfattning
- 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.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Godkända värden: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
None
Den här cmdleten har inga parametrar som tar indata efter värde. Du kan dock skicka värdena för ComputerName och NewName egenskaper 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.
Kommentarer
Den här cmdleten är endast tillgänglig på Windows-plattformar.
