Rename-Computer
Přejmenuje počítač.
Syntax
Default (Výchozí)
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-Protocol <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina Rename-Computer přejmenuje místní počítač nebo vzdálený počítač.
V každém příkazu přejmenuje jeden počítač.
Tato rutina byla zavedena ve Windows PowerShellu 3.0.
Příklady
Příklad 1: Přejmenování místního počítače
Tento příkaz přejmenuje místní počítač na Server044 a restartuje ho, aby se změna projevila.
Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart
Příklad 2: Přejmenování vzdáleného počítače
Tento příkaz přejmenuje Srv01 počítač na Server001. Počítač se nerestartuje.
Parametr DomainCredential určuje přihlašovací údaje uživatele, který má oprávnění k přejmenování počítačů v doméně.
Parametr Force potlačí výzvu k potvrzení.
Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force
Parametry
-ComputerName
Přejmenuje zadaný vzdálený počítač. Výchozí hodnota je místní počítač.
Zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény vzdáleného počítače.
Chcete-li zadat místní počítač, zadejte název počítače, tečku (.) nebo localhost.
Tento parametr nespoléhá na vzdálenou správu PowerShellu.
Parametr ComputerName můžete použít v rámci Rename-Computer, i když váš počítač není nakonfigurován pro spouštění vzdálených příkazů.
Vlastnosti parametru
| Typ: | String |
| Default value: | Local Computer |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-DomainCredential
Určuje uživatelský účet, který má oprávnění pro připojení k doméně. Explicitní přihlašovací údaje se vyžadují k přejmenování počítače, který je připojený k doméně.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential, například objekt vygenerovaný rutinou Get-Credential.
Pokud zadáte uživatelské jméno, tato rutina vás vyzve k zadání hesla.
Chcete-li zadat uživatelský účet, který má oprávnění pro připojení k počítači určenému parametrem ComputerName, použijte parametr LocalCredential.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-LocalCredential
Určuje uživatelský účet, který má oprávnění pro připojení k počítači určenému parametrem ComputerName. Výchozí hodnota je aktuální uživatel.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential, například objekt vygenerovaný rutinou Get-Credential.
Pokud zadáte uživatelské jméno, tato rutina vás vyzve k zadání hesla.
Pokud chcete zadat uživatelský účet, který má oprávnění pro připojení k doméně, použijte parametr DomainCredential.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | Current User |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-NewName
Určuje nový název počítače. Tento parametr je povinný.
Standardní názvy mohou obsahovat písmena (a-z), (A-Z), čísla (0-9) a pomlčky (-), ale bez mezer nebo tečk (.). Název nemusí obsahovat pouze číslice a nesmí být delší než 63 znaků.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí výsledky příkazu. Jinak tento příkaz negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Protocol
Určuje protokol, který se má použít k přejmenování počítače. Přijatelné hodnoty pro tento parametr jsou: WSMan a DCOM. Výchozí hodnota je DCOM.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Přípustné hodnoty: | DCOM, WSMan |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Restart
Označuje, že tato rutina restartuje počítač, který byl přejmenován. K efektivní změně se často vyžaduje restartování.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WsmanAuthentication
Určuje mechanismus, který se používá k ověření přihlašovacích údajů uživatele, když tato rutina používá protokol WSMan. Přijatelné hodnoty pro tento parametr jsou:
- Základní
- CredSSP
- výchozí
- Přehled
- Kerberos
- Vyjednávat
Výchozí hodnota je Default.
Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism – výčet.
Výstraha
Ověřování poskytovatele služeb zabezpečení pověření (CredSSP), ve kterém jsou přihlašovací údaje uživatele předány vzdálenému počítači k ověření, je navrženo pro příkazy, které vyžadují ověření na více než jednom prostředku, například při přístupu ke vzdálené síťové sdílené složce. Tento mechanismus zvyšuje riziko zabezpečení vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, dají se přihlašovací údaje předávané k řízení > síťové relaci použít.
Tento parametr byl představen ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Přípustné hodnoty: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
None
Tato rutina nemá parametry, které přebírají vstup podle hodnoty. Hodnoty vlastností objektů ComputerName a NewName můžete však předat této rutině.
Výstupy
ComputerChangeInfo
Tato rutina vrátí objekt ComputerChangeInfo, pokud zadáte parametr PassThru. Jinak nevrací žádný výstup.