Rename-Computer

Zmienia nazwę komputera.

Składnia

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

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie Rename-Computer cmdlet zmienia nazwę komputera lokalnego lub komputera zdalnego. Zmienia nazwę jednego komputera w każdym poleceniu.

To polecenie cmdlet zostało wprowadzone w Windows PowerShell 3.0.

Przykłady

Przykład 1. Zmiana nazwy komputera lokalnego

To polecenie zmienia nazwę komputera lokalnego na Server044 , a następnie uruchamia go ponownie, aby wprowadzić zmianę w życie.

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

Przykład 2. Zmiana nazwy komputera zdalnego

To polecenie zmienia nazwę Srv01 komputera na Server001. Komputer nie jest uruchamiany ponownie.

Parametr DomainCredential określa poświadczenia użytkownika, który ma uprawnienia do zmiany nazwy komputerów w domenie.

Parametr Force pomija monit o potwierdzenie.

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

Parametry

-ComputerName

Zmienia nazwę określonego komputera zdalnego. Wartością domyślną jest komputer lokalny.

Wpisz nazwę NetBIOS, adres IP lub w pełni kwalifikowaną nazwę domeny komputera zdalnego. Aby określić komputer lokalny, wpisz nazwę komputera, kropkę (.) lub localhost.

Ten parametr nie polega na komunikacji zdalnej programu PowerShell. Można użyć parametru Rename-ComputerComputerName, nawet jeśli komputer nie jest skonfigurowany do uruchamiania poleceń zdalnych.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainCredential

Określa konto użytkownika, które ma uprawnienia do nawiązywania połączenia z domeną. Jawne poświadczenia są wymagane do zmiany nazwy komputera przyłączonego do domeny.

Wpisz nazwę użytkownika, taką jak User01 lub Domain01\User01, lub wprowadź obiekt PSCredential , taki jak jeden wygenerowany przez Get-Credential polecenie cmdlet.

Jeśli wpiszesz nazwę użytkownika, to polecenie cmdlet wyświetli monit o podanie hasła.

Aby określić konto użytkownika z uprawnieniem do nawiązywania połączenia z komputerem określonym przez parametr ComputerName , użyj parametru LocalCredential .

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

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

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

-LocalCredential

Określa konto użytkownika, które ma uprawnienia do nawiązywania połączenia z komputerem określonym przez parametr ComputerName . Wartość domyślna to użytkownik bieżący.

Wpisz nazwę użytkownika, taką jak User01 lub Domain01\User01, lub wprowadź obiekt PSCredential , taki jak jeden wygenerowany przez Get-Credential polecenie cmdlet.

Jeśli wpiszesz nazwę użytkownika, to polecenie cmdlet wyświetli monit o podanie hasła.

Aby określić konto użytkownika, które ma uprawnienia do nawiązywania połączenia z domeną, użyj parametru DomainCredential .

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

-NewName

Określa nową nazwę komputera. Ten parametr jest wymagany.

Nazwy standardowe mogą zawierać litery (), (), cyfry (a-z0-9) i łączniki (-), ale nie spacje ani kropki (.).A-Z Nazwa może nie składać się całkowicie z cyfr i może nie być dłuższa niż 63 znaki

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

-PassThru

Zwraca wyniki polecenia. W przeciwnym razie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

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

-Restart

Wskazuje, że to polecenie cmdlet uruchamia ponownie komputer, którego nazwa została zmieniona. Ponowne uruchomienie jest często wymagane do wprowadzenia zmiany w życie.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-WsmanAuthentication

Określa mechanizm używany do uwierzytelniania poświadczeń użytkownika, gdy to polecenie cmdlet używa protokołu WSMan. Dopuszczalne wartości dla tego parametru to:

  • Podstawowa
  • Protokół CredSSP
  • Domyślny
  • Skrót
  • Protokół Kerberos
  • Negocjować

Wartość domyślna to Domyślna.

Aby uzyskać więcej informacji na temat wartości tego parametru, zobacz AuthenticationMechanism Enumeration (Wyliczenie AuthenticationMechanism).

Ostrzeżenie

Uwierzytelnianie dostawcy usług zabezpieczeń poświadczeń (CredSSP), w którym poświadczenia użytkownika są przekazywane do komputera zdalnego do uwierzytelnienia, jest przeznaczone do poleceń wymagających uwierzytelniania w więcej niż jednym zasobie, na przykład uzyskiwania dostępu do udziału sieci zdalnej. Ten mechanizm zwiększa ryzyko bezpieczeństwa operacji zdalnej. Jeśli bezpieczeństwo komputera zdalnego zostanie naruszone, poświadczenia przekazane do niego mogą służyć do kontrolowania > sesji sieciowej.

Ten parametr został wprowadzony w Windows PowerShell 3.0.

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

Dane wejściowe

None

To polecenie cmdlet nie ma parametrów, które pobierają dane wejściowe według wartości. Można jednak potokować wartości właściwości ComputerName i NewName obiektów do tego polecenia cmdlet.

Dane wyjściowe

ComputerChangeInfo

To polecenie cmdlet zwraca obiekt ComputerChangeInfo , jeśli określisz parametr PassThru . W przeciwnym razie nie zwraca żadnych danych wyjściowych.

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach systemu Windows.