Rename-Computer

Referencia

Modul:: Microsoft.PowerShell.Management

Átnevez egy számítógépet.

Syntax

Rename-Computer
      [-ComputerName <String>]
      [-PassThru]
      [-DomainCredential <PSCredential>]
      [-LocalCredential <PSCredential>]
      [-NewName] <String>
      [-Force]
      [-Restart]
      [-WsmanAuthentication <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Ez a parancsmag csak a Windows platformon érhető el.

A Rename-Computer parancsmag átnevezi a helyi számítógépet vagy egy távoli számítógépet. Minden parancsban egy számítógépet nevez át.

Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.

Példák

1. példa: A helyi számítógép átnevezése

Ez a parancs átnevezi a helyi számítógépet Server044, majd újraindítja a módosítás hatékonyságának érdekében.

Rename-Computer -NewName "Server044" -DomainCredential Domain01\Admin01 -Restart

2. példa: Távoli számítógép átnevezése

Ez a parancs átnevezi a Srv01 számítógépet Server001. A számítógép nem indul újra.

A DomainCredential paraméter egy olyan felhasználó hitelesítő adatait adja meg, aki jogosult a tartomány számítógépeinek átnevezésére.

A Force paraméter letiltja a megerősítési kérést.

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

Paraméterek

-ComputerName

Átnevezi a megadott távoli számítógépet. Az alapértelmezett beállítás a helyi számítógép.

Írja be egy távoli számítógép NetBIOS-nevét, IP-címét vagy teljes tartománynevét. A helyi számítógép megadásához írja be a számítógép nevét, egy pont (.) vagy localhost.

Ez a paraméter nem támaszkodik a PowerShell távoli elérésre. A Rename-Computer paraméterét akkor is használhatja, ha a számítógép nincs távoli parancsok futtatására konfigurálva.

Típus:	String
Position:	Named
Alapértelmezett érték:	Local Computer
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Típus:	SwitchParameter
Aliasok:	cf
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-DomainCredential

Olyan felhasználói fiókot ad meg, amely jogosult a tartományhoz való csatlakozásra. A tartományhoz csatlakoztatott számítógép átnevezéséhez explicit hitelesítő adatokra van szükség.

Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot.

Ha felhasználónevet ír be, ez a parancsmag jelszó megadását kéri.

Ha olyan felhasználói fiókot szeretne megadni, amely jogosult a ComputerName paraméter által megadott számítógéphez való csatlakozásra, használja a LocalCredential paramétert.

Típus:	PSCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-LocalCredential

Olyan felhasználói fiókot ad meg, amely jogosult csatlakozni a ComputerName paraméter által megadott számítógéphez. Az alapértelmezett az aktuális felhasználó.

Írjon be egy felhasználónevet, például User01 vagy Domain01\User01, vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot.

Ha felhasználónevet ír be, ez a parancsmag jelszó megadását kéri.

Ha olyan felhasználói fiókot szeretne megadni, amely jogosult a tartományhoz való csatlakozásra, használja a DomainCredential paramétert.

Típus:	PSCredential
Position:	Named
Alapértelmezett érték:	Current User
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-NewName

A számítógép új nevét adja meg. Ez a paraméter kötelező.

A standard név tartalmazhat betűket (a-z), (A-Z), számokat (0-9) és kötőjeleket (-), de nem tartalmazhat szóközöket vagy pontokat (.). A név nem állhat teljes egészében számjegyekből, és legfeljebb 63 karakter hosszúságú lehet

Típus:	String
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-PassThru

A parancs eredményeit adja vissza. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Restart

Azt jelzi, hogy ez a parancsmag újraindítja az átnevezett számítógépet. A módosítás hatékonyságának eléréséhez gyakran szükség van újraindításra.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Típus:	SwitchParameter
Aliasok:	wi
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-WsmanAuthentication

Megadja azt a mechanizmust, amely a felhasználói hitelesítő adatok hitelesítésére szolgál, amikor ez a parancsmag a WSMan protokollt használja. A paraméter elfogadható értékei a következők:

Alapszintű
CredSSP
alapértelmezett
Összefoglaló
Kerberos
Tárgyal

Az alapértelmezett érték Alapértelmezett.

A paraméter értékeivel kapcsolatos további információkért lásd AuthenticationMechanism Enumeration.

Figyelmeztetés

A hitelesítő adatok biztonsági szolgáltatójának (CredSSP) hitelesítése, amelyben a felhasználói hitelesítő adatok átadva vannak egy hitelesítendő távoli számítógépnek, olyan parancsokhoz készült, amelyek több erőforráson is hitelesítést igényelnek, például távoli hálózati megosztáshoz való hozzáféréshez. Ez a mechanizmus növeli a távoli művelet biztonsági kockázatát. Ha a távoli számítógép biztonsága sérül, a neki átadott hitelesítő adatok a hálózati munkamenet > vezérlésére használhatók.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Típus:	String
Elfogadott értékek:	Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

Bevitelek

None

Ez a parancsmag nem rendelkezik olyan paraméterekkel, amelyek érték szerint fogadják a bemenetet. Azonban a ComputerName és NewName objektumtulajdonságok értékeit átiranyíthatja ehhez a parancsmaghoz.

Kimenetek