Sdílet prostřednictvím

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>]
      [-Protocol <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Rutina Rename-Computer přejmenuje místní nebo vzdálený počítač. V každém příkazu přejmenuje jeden počítač.

Tato rutina byla zavedena v Windows PowerShell 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 potom ho restartuje, 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 počítač na Srv01Server001. Počítač není restartován.

Parametr DomainCredential určuje pověření 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í hodnotou je místní počítač.

Zadejte název rozhraní NetBIOS, IP adresu nebo plně kvalifikovaný název domény vzdáleného počítače. Pokud chcete 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ý ke spouštění vzdálených Rename-Computer příkazů.

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ě. K přejmenování počítače, který je připojený k doméně, se vyžadují explicitní přihlašovací údaje.

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 .

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 žádosti o potvrzení uživatele.

Type:SwitchParameter
Position:Named
Default value:False
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 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 .

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 můžou obsahovat písmena (), (A-Z), číslice (0-9) a spojovníky (-), ale nesmí obsahovat mezery ani tečky (.).a-z Název nesmí 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

-Protocol

Určuje, který protokol se má použít k přejmenování počítače. Přijatelné hodnoty pro tento parametr jsou: WSMan a DCOM. Výchozí hodnota je DCOM.

Tento parametr byl zaveden v Windows PowerShell 3.0.

Type:String
Accepted values:DCOM, WSMan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Restart

Označuje, že tato rutina restartuje přejmenovaný počítač. K tomu, aby se změna projevila, 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
  • Default
  • Výtah
  • Kerberos
  • Vyjednávat

Výchozí hodnota je Výchozí.

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

Upozornění

Ověřování credSSP (Credential Security Service Provider), při kterém se přihlašovací údaje uživatele předávají vzdálenému počítači k ověření, je určeno pro příkazy, které vyžadují ověření u více než jednoho prostředku, jako je například přístup ke vzdálené sdílené síťové složce. Tento mechanismus zvyšuje bezpečnostní riziko vzdálené operace. Pokud dojde k ohrožení zabezpečení vzdáleného počítače, mohou být k řízení > síťové relace použity přihlašovací údaje, které jsou mu předány.

Tento parametr byl zaveden v Windows PowerShell 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á parametry, které přebírají vstup podle hodnoty. Hodnoty vlastností Objektů ComputerName a NewName však můžete předvést do této rutiny.

Výstupy

ComputerChangeInfo

Tato rutina vrátí objekt ComputerChangeInfo , pokud zadáte parametr PassThru . V opačném případě nevrací žádný výstup.