Rename-Computer
Přejmenuje počítač.
Rename-Computer
[-ComputerName <String>]
[-PassThru]
[-DomainCredential <PSCredential>]
[-LocalCredential <PSCredential>]
[-NewName] <String>
[-Force]
[-Restart]
[-WsmanAuthentication <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
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.
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
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
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álené komunikace PowerShellu.
Parametr
Typ: | String |
Position: | Named |
Default value: | Local Computer |
Vyžadováno: | False |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
Před spuštěním rutiny vás vyzve k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
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.
Typ: | PSCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
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.
Typ: | PSCredential |
Position: | Named |
Default value: | Current User |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
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ů.
Typ: | String |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
Vrátí výsledky příkazu. Jinak tato rutina negeneruje žádný výstup.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Označuje, že tato rutina restartuje počítač, který byl přejmenován. K efektivní změně se často vyžaduje restartování.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
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:
- Basic
- credSSP
- výchozí
- digest
- Kerberos
- Negotiate
Výchozí hodnota je Výchozí.
Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism – výčet.
Upozornění
Ověřování zprostředkovatele služby CredSSP (Credential Security Service Provider), ve kterém jsou přihlašovací údaje uživatele předány vzdálenému počítači, který se má ověřit, je určený pro příkazy, které vyžadují ověření u více než jednoho prostředku, například pro přístup 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.
Typ: | String |
Přípustné hodnoty: | Default, Basic, Negotiate, CredSSP, Digest, Kerberos |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
None
Tato rutina nemá žádné parametry, které přebírají vstup podle hodnoty. Hodnoty ComputerName však můžete a NewName vlastnosti objektů do této rutiny.
None
Ve výchozím nastavení tato rutina nevrací žádný výstup.
Pokud použijete parametr
Tato rutina je dostupná jenom na platformách Windows.