Udostępnij za pośrednictwem

Rename-Computer

  • Odwołanie
Moduł:
Microsoft.PowerShell.Management

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 cmdlet Rename-Computer zmienia nazwę komputera lokalnego lub komputera zdalnego. Zmienia nazwę jednego komputera przy każdym poleceniu.

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

Przykłady

Przykład 1. Zmiana nazwy komputera lokalnego

To polecenie zmienia nazwę komputera lokalnego na Server044, a następnie ponownie uruchamia go, aby wprowadzić zmianę obowiązującą.

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

Przykład 2. Zmiana nazwy komputera zdalnego

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

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.

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

Parametry

-ComputerName

Zmienia nazwę określonego komputera zdalnego. Wartość domyślna to 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 opiera się na zdalnym zarządzaniu PowerShell. Można użyć parametru ComputerNameRename-Computer nawet jeśli komputer nie jest skonfigurowany do uruchamiania poleceń zdalnych.

Typ:String
Position:Named
Domyślna wartość:Local Computer
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DomainCredential

Określa konto użytkownika, które ma uprawnienia do nawiązywania połączenia z domeną. Aby zmienić nazwę komputera przyłączonego do domeny, wymagane są jawne poświadczenia.

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

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 łączenia się z komputerem określonym przez parametr ComputerName, użyj parametru LocalCredential.

Typ:PSCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-LocalCredential

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

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

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.

Typ:PSCredential
Position:Named
Domyślna wartość:Current User
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NewName

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

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

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Restart

Wskazuje, że polecenie cmdlet ponownie uruchamia komputer, którego nazwę zmieniono. Ponowne uruchomienie jest często wymagane, aby wprowadzić zmianę w życie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 tego parametru to:

  • Podstawowa
  • CredSSP
  • domyślne
  • skrótu
  • Kerberos
  • Negocjować

Wartość domyślna to Default.

Aby uzyskać więcej informacji o wartościach tego parametru, zobacz AuthenticationMechanism Enumeration.

Ostrzeżenie

Uwierzytelnianie przez dostawcę usług zabezpieczających poświadczenia (CredSSP), w ramach którego poświadczenia użytkownika są przekazywane do zdalnego komputera w celu uwierzytelnienia, jest zaprojektowane dla poleceń wymagających uwierzytelnienia na więcej niż jednym zasobie, takich jak uzyskiwanie dostępu do zdalnego zasobu sieciowego. Ten mechanizm zwiększa ryzyko bezpieczeństwa operacji zdalnej. W przypadku naruszenia zabezpieczeń komputera zdalnego poświadczenia przekazywane do niego mogą służyć do kontrolowania > sesji sieciowej.

Ten parametr został wprowadzony w programie Windows PowerShell 3.0.

Typ:String
Dopuszczalne wartości:Default, Basic, Negotiate, CredSSP, Digest, Kerberos
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

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

Dane wyjściowe

None

Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.

RenameComputerChangeInfo

Jeśli używasz parametru PassThru, to polecenie cmdlet zwraca obiekt RenameComputerChangeInfo.

Uwagi

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