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 számítógépet a Srv01 következőre 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.

Rename-Computer -ComputerName "Srv01" -NewName "Server001" -DomainCredential Domain01\Admin01 -Force

Paraméterek

-ComputerName

Átnevezi a megadott távoli számítógépet. Alapértelmezés szerint 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-újraküldésre. Akkor is használhatja a ComputerName paramétert Rename-Computer , ha a számítógép nincs távoli parancsok futtatására konfigurálva.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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írjon be egy PSCredential objektumot, például a parancsmag által Get-Credential létrehozott objektumot.

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

A ComputerName paraméter által megadott számítógéphez való csatlakozásra engedéllyel rendelkező felhasználói fiók megadásához használja a LocalCredential paramétert.

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

-Force

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

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

-LocalCredential

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

Írjon be egy felhasználónevet, például User01 vagy Domain01\User01írjon be egy PSCredential objektumot, például a parancsmag által Get-Credential 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.

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

-NewName

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

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

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

-PassThru

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

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

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

  • Basic
  • CredSSP
  • Alapértelmezett
  • Digest
  • Kerberos
  • Tárgyalni

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

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ő adatokkal szabályozható > a hálózati munkamenet.

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

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

Bevitelek

None

Ez a parancsmag nem rendelkezik olyan paraméterekkel, amelyek érték szerint fogadják a bemenetet. Az objektumok ComputerName és NewName tulajdonságának értékeit azonban erre a parancsmagra helyezheti.

Kimenetek

None

Alapértelmezés szerint ez a parancsmag nem ad vissza kimenetet.

RenameComputerChangeInfo

A PassThru paraméter használatakor ez a parancsmag egy RenameComputerChangeInfo objektumot ad vissza.

Jegyzetek

Ez a parancsmag csak Windows-platformokon érhető el.