Sdílet prostřednictvím

Rename-Computer

  • Reference
Modul:
Microsoft.PowerShell.Management

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

$renameParams = @{
    ComputerName = "Srv01"
    NewName = "Server001"
    DomainCredential = "Domain01\Admin01"
    Force = $true
}
Rename-Computer @renameParams

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

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 cmdletu 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, aniž by bylo vyžadováno potvrzení od 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 tento příkaz 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 cmdlet spustí. Cmdlet 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í
  • Přehled
  • Kerberos
  • Vyjednávat

Výchozí hodnota je Default.

Další informace o hodnotách tohoto parametru naleznete v tématu AuthenticationMechanism – výčet.

Varování

Ověřování zprostředkovatele služby CredSSP (Credential Security Service Provider), ve kterém jsou uživatelské přihlašovací údaje předány vzdálenému počítači k ověření, je určené pro příkazy vyžadující ověření u více než jednoho 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.

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