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ę obowiązującą.
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ć parametruRename-Computer
ComputerName, nawet jeśli komputer nie jest skonfigurowany do uruchamiania poleceń zdalnych.
Type: | String |
Position: | Named |
Default value: | Local Computer |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainCredential
Określa konto użytkownika, które ma uprawnienia do łączenia się z domeną. Aby zmienić nazwę komputera przyłączonego do domeny, wymagane są poświadczenia jawne.
Wpisz nazwę użytkownika, taką jak User01
lub Domain01\User01
, lub wprowadź obiekt PSCredential , taki jak 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 łączenia się z komputerem określonym przez parametr ComputerName , użyj parametru LocalCredential .
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 użytkownik bieżący.
Wpisz nazwę użytkownika, taką jak User01
lub Domain01\User01
, lub wprowadź obiekt PSCredential , taki jak 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 łączenia się z domeną, użyj parametru DomainCredential .
Type: | PSCredential |
Position: | Named |
Default value: | Current User |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Określa nową nazwę komputera. Ten parametr jest wymagany.
Nazwy standardowe mogą zawierać litery (), (A-Z
), cyfry (0-9
) i łączniki (-
), ale nie ma spacji ani kropek (.
).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 |
Required: | True |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Restart
Wskazuje, że to polecenie cmdlet ponownie uruchamia komputer, którego nazwa została zmieniona. Ponowne uruchomienie jest często wymagane, aby wprowadzić zmianę w życie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | 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
- Default
- 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 dla poleceń wymagających uwierzytelniania w więcej niż jednym zasobie, takich jak uzyskiwanie dostępu do zdalnego udziału 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 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 |
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ć wartości właściwości ComputerName i NewName obiektów do tego polecenia cmdlet.
Dane wyjściowe
None
Domyślnie to polecenie cmdlet nie zwraca żadnych danych wyjściowych.
Jeśli używasz parametru PassThru , to polecenie cmdlet zwraca obiekt RenameComputerChangeInfo .
Uwagi
To polecenie cmdlet jest dostępne tylko na platformach Windows.