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>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Tato rutina je dostupná jenom na platformě Windows.
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: | 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 |
-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 |
-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á žádné 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
None
Ve výchozím nastavení tato rutina nevrací žádný výstup.
RenameComputerChangeInfo
Pokud použijete parametr PassThru, vrátí tato rutina objekt RenameComputerChangeInfo.
Poznámky
Tento cmdlet je dostupný pouze na platformách Windows.