Číst v angličtině

Sdílet prostřednictvím


Rename-Computer

Přejmenuje počítač.

Syntaxe

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álené komunikace PowerShellu. Parametr ComputerName můžete použít i v případě, že počítač není nakonfigurovaný tak, aby spouštět vzdálené příkazy.

Typ:String
Position:Named
Default value:Local Computer
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Confirm

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

-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.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

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

-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.

Typ:PSCredential
Position:Named
Default value:Current User
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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ů.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PassThru

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

-Restart

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

-WhatIf

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

-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:

  • 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

Vstupy

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.

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

Tato rutina je dostupná jenom na platformách Windows.