Rename-Computer

  • Reference
Modul:
Microsoft.PowerShell.Management

Přejmenuje počítač.

Syntax

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 místní počítač 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č. Ve výchozím nastavení je to 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 ComputerNameRename-Computer můžete použít i v případě, že počítač není nakonfigurovaný tak, aby spouštět vzdálené příkazy.

Type:String
Position:Named
Default value:Local Computer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 nebo zadejte objekt PSCredential, například objekt vygenerovaný rutinou Get-CredentialDomain01\User01.

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 .

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalCredential

Určuje uživatelský účet, který má oprávnění pro připojení k počítači určenému parametrem ComputerName . Ve výchozím nastavení je to aktuální uživatel.

Zadejte uživatelské jméno, například User01 nebo nebo zadejte objekt PSCredential, například objekt vygenerovaný rutinou Get-CredentialDomain01\User01.

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 doméně, použijte parametr DomainCredential .

Type:PSCredential
Position:Named
Default value:Current User
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewName

Určuje nový název počítače. Tento parametr je povinný.

Standardní názvy mohou obsahovat písmena (), (A-Z), čísla (0-9) a pomlčky (-), ale nesmí obsahovat mezery ani tečky (.).a-z Název nemusí obsahovat pouze číslice a nesmí být delší než 63 znaků.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Vrátí výsledky příkazu. Jinak tato rutina negeneruje žádný výstup.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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í.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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. Tento parametr přijímá tyto hodnoty:

  • Basic
  • Credssp
  • Výchozí
  • Digest
  • Kerberos
  • Vyjednávat

Výchozí hodnota je Default.

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

Upozorňující

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 k řízení > síťové relace použít přihlašovací údaje, které jsou mu předány.

Tento parametr byl představen ve Windows PowerShellu 3.0.

Type:String
Accepted values:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None

Tato rutina nemá žádné parametry, které přebírají vstup podle hodnoty. Do této rutiny však můžete převést hodnoty vlastností ComputerName a NewName objektů.

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.