Add-Computer
Dodaj komputer lokalny do domeny lub grupy roboczej.
Składnia
Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-UnjoinDomainCredential <PSCredential>]
-Credential <PSCredential>
[-DomainName] <String>
[-OUPath <String>]
[-Server <String>]
[-Unsecure]
[-Options <JoinOptions>]
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-Credential <PSCredential>]
[-WorkgroupName] <String>
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Opis
Polecenie cmdlet Add-Computer dodaje komputer lokalny lub komputery zdalne do domeny lub grupy roboczej albo przenosi je z jednej domeny do innej.
Tworzy również konto domeny, jeśli komputer zostanie dodany do domeny bez konta.
Możesz użyć parametrów tego polecenia cmdlet, aby określić jednostkę organizacyjną (OU) i kontroler domeny lub wykonać niezabezpieczone sprzężenie.
Aby uzyskać wyniki polecenia, użyj parametrów Verbose i PassThru.
Przykłady
Przykład 1: Dodawanie komputera lokalnego do domeny, a następnie ponowne uruchomienie komputera
Add-Computer -DomainName Domain01 -RestartTo polecenie dodaje komputer lokalny do domeny Domain01, a następnie ponownie uruchamia komputer, aby wprowadzić zmianę obowiązującą.
Przykład 2. Dodawanie komputera lokalnego do grupy roboczej
Add-Computer -WorkgroupName WORKGROUP-ATo polecenie dodaje komputer lokalny do grupy roboczej Workgroup-A.
Przykład 3. Dodawanie komputera lokalnego do domeny
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -VerboseTo polecenie dodaje komputer lokalny do domeny Domain01 przy użyciu kontrolera domeny Domain01\DC01.
Polecenie używa parametrów PassThru i Pełne, aby uzyskać szczegółowe informacje o wynikach polecenia.
Przykład 4. Dodawanie komputera lokalnego do domeny przy użyciu parametru OUPath
Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"To polecenie dodaje komputer lokalny do domeny Domain02. Używa parametru OUPath do określenia jednostki organizacyjnej dla nowych kont.
Przykład 5. Dodawanie komputera lokalnego do domeny przy użyciu poświadczeń
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -ForceTo polecenie dodaje komputer Server01 do domeny Domain02. Używa on parametru LocalCredential, aby określić konto użytkownika, które ma uprawnienia do nawiązywania połączenia z komputerem Server01. Używa parametru Credential, aby określić konto użytkownika, które ma uprawnienia do dołączania komputerów do domeny. Używa parametru Restart, aby ponownie uruchomić komputer po zakończeniu operacji sprzężenia, a parametr Force pomijać komunikaty potwierdzenia użytkownika.
Przykład 6. Przenoszenie grupy komputerów do nowej domeny
Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -RestartTo polecenie przenosi komputery Server01 i Server02 oraz komputer lokalny z domeny01 do domeny02.
Używa on parametru LocalCredential, aby określić konto użytkownika, które ma uprawnienia do łączenia się z trzema komputerami, których dotyczy problem. Używa on parametru UnjoinDomainCredential, aby określić konto użytkownika, które ma uprawnienia do odłączenia komputerów z domeny Domain01 i parametru Credential, aby określić konto użytkownika, które ma uprawnienia do dołączania komputerów do domeny Domain02. Używa on parametru Restart , aby ponownie uruchomić wszystkie trzy komputery po zakończeniu przenoszenia.
Przykład 7: Przenoszenie komputera do nowej domeny i zmienianie nazwy komputera
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -RestartTo polecenie przenosi komputer Server01 do domeny02 i zmienia nazwę komputera na Server044.
Polecenie używa poświadczeń bieżącego użytkownika do nawiązania połączenia z komputerem Server01 i odłącz go od bieżącej domeny. Używa parametru Credential, aby określić konto użytkownika, które ma uprawnienia do przyłączenia komputera do domeny Domain02.
Przykład 8. Dodawanie komputerów wymienionych w pliku do nowej domeny
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -RestartTo polecenie dodaje komputery wymienione w pliku Servers.txt do domeny Domain02.
Używa parametru Opcje
Parametry
-ComputerName
Określa komputery do dodania do domeny lub grupy roboczej. Wartość domyślna to komputer lokalny.
Wpisz nazwę NetBIOS, adres IP (Internet Protocol) lub w pełni kwalifikowaną nazwę domeny każdego z komputerów zdalnych. Aby określić komputer lokalny, wpisz nazwę komputera, kropkę (.) lub "localhost".
Ten parametr nie opiera się na komunikacji zdalnej programu Windows PowerShell.
Można użyć parametru ComputerNameAdd-Computer nawet jeśli komputer nie jest skonfigurowany do uruchamiania poleceń zdalnych.
Ten parametr jest wprowadzany w programie Windows PowerShell 3.0.
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | Local computer |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Credential
Określa konto użytkownika, które ma uprawnienia do dołączania komputerów do nowej domeny. 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, zostanie wyświetlony monit o podanie hasła.
Aby określić konto użytkownika z uprawnieniami do usuwania komputera z bieżącej domeny, użyj parametru UnjoinDomainCredential. Aby określić konto użytkownika, które ma uprawnienia do nawiązywania połączenia z komputerem zdalnym, użyj parametru LocalCredential.
| Typ: | PSCredential |
| Aliasy: | DomainCredential |
| Position: | Named |
| Domyślna wartość: | Current User Account Credentials |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DomainName
Określa domenę, do której są dodawane komputery. Ten parametr jest wymagany podczas dodawania komputerów do domeny.
| Typ: | String |
| Aliasy: | DN, Domain |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Force
Pomija monit o potwierdzenie użytkownika.
Bez tego parametru Add-Computer wymaga potwierdzenia dodania każdego komputera.
Ten parametr jest wprowadzany w programie Windows PowerShell 3.0.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | False |
| 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 komputerami określonymi 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, zostanie wyświetlony monit o podanie hasła.
Aby określić konto użytkownika, które ma uprawnienia do dodawania komputerów do nowej domeny, użyj parametru Credential. Aby określić konto użytkownika z uprawnieniami do usuwania komputerów z bieżącej domeny, użyj parametru UnjoinDomainCredential.
Ten parametr jest wprowadzany w programie Windows PowerShell 3.0.
| 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 w nowej domenie. Ten parametr jest prawidłowy tylko wtedy, gdy jeden komputer jest dodawany lub przenoszony.
Ten parametr jest wprowadzany w programie Windows PowerShell 3.0.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Options
Określa opcje zaawansowane dla operacji Add-Computer join. Wprowadź co najmniej jedną wartość w ciągu rozdzielanym przecinkami.
Dopuszczalne wartości tego parametru to:
kontoTworzenie: tworzy konto domeny. Polecenie cmdlet Add-Computer automatycznie tworzy konto domeny podczas dodawania komputera do domeny. Ta opcja jest uwzględniona w celu ukończenia.
Win9XUpgrade: wskazuje, że operacja sprzężenia jest częścią uaktualnienia systemu operacyjnego Windows.
UnsecuredJoin: wykonuje niezabezpieczone sprzężenia. Aby zażądać niezabezpieczonego sprzężenia, użyj parametru Niezabezpieczone lub tej opcji.
PasswordPass : ustawia hasło maszyny na wartość parametrucredential(DomainCredential) po wykonaniu niezabezpieczonego sprzężenia. Ta opcja wskazuje również, że wartość parametru Credential (DomainCredential) jest hasłem maszyny, a nie hasłem użytkownika. Ta opcja jest prawidłowa tylko wtedy, gdy określono opcję NiezabezpieczoneJoin.
-- JoinWithNewName: zmienia nazwę komputera w nowej domenie na nazwę określoną przez parametr NewName. Jeśli używasz parametru NewName, ta opcja jest ustawiana automatycznie. Ta opcja jest przeznaczona do użycia z poleceniem cmdlet Rename-Computer. Jeśli używasz polecenia cmdlet Rename-Computer do zmiany nazwy komputera, ale nie uruchamiaj ponownie komputera, aby wprowadzić zmianę, możesz użyć tego parametru, aby dołączyć komputer do domeny z nową nazwą.
JoinReadOnly: używa istniejącego konta komputera do przyłączenia komputera do kontrolera domeny tylko do odczytu. Konto komputera musi zostać dodane do listy dozwolonych zasad replikacji haseł, a hasło konta musi zostać zreplikowane do kontrolera domeny tylko do odczytu przed operacją sprzężenia.
InstallInvoke: ustawia flagi create (0x2) i delete (0x4) FJoinOptions parametru JoinDomainOrWorkgroup. Aby uzyskać więcej informacji na temat metody JoinDomainOrWorkgroup, zobacz JoinDomainOrWorkgroup metody klasy Win32_ComputerSystem w bibliotece MSDN. Aby uzyskać więcej informacji na temat tych opcji, zobacz funkcji NetJoinDomain w bibliotece MSDN.
Ten parametr został wprowadzony w programie Windows PowerShell 3.0.
| Typ: | JoinOptions |
| Dopuszczalne wartości: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-OUPath
Określa jednostkę organizacyjną (OU) dla konta domeny. Wprowadź pełną nazwę wyróżniającą jednostki organizacyjnej w cudzysłowie. Wartość domyślna to domyślna jednostka organizacyjna dla obiektów maszyn w domenie.
| Typ: | String |
| Aliasy: | OU |
| Position: | Named |
| Domyślna wartość: | The default OU for machine objects for in the domain |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-PassThru
Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Restart
Uruchamia ponownie komputery dodane do domeny lub grupy roboczej. Ponowne uruchomienie jest często wymagane, aby wprowadzić zmianę w życie.
Ten parametr jest wprowadzany w programie Windows PowerShell 3.0.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Server
Określa nazwę kontrolera domeny, który dodaje komputer do domeny. Wprowadź nazwę w formacie DomainName\ComputerName. Domyślnie nie określono kontrolera domeny.
| Typ: | String |
| Aliasy: | DC |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-UnjoinDomainCredential
Określa konto użytkownika, które ma uprawnienia do usuwania komputerów z ich bieżących domen. 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, zostanie wyświetlony monit o podanie hasła.
Użyj tego parametru podczas przenoszenia komputerów do innej domeny. Aby określić konto użytkownika, które ma uprawnienia do dołączenia do nowej domeny, użyj parametru Credential. Aby określić konto użytkownika, które ma uprawnienia do nawiązywania połączenia z komputerem zdalnym, użyj parametru LocalCredential.
Ten parametr jest wprowadzany w programie Windows PowerShell 3.0.
| Typ: | PSCredential |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Unsecure
Wykonuje niezabezpieczone sprzężenie do określonej domeny.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | False |
| 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 jest uruchamiane.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-WorkgroupName
Określa nazwę grupy roboczej, do której są dodawane komputery. Wartość domyślna to "WORKGROUP".
| Typ: | String |
| Aliasy: | WGN |
| Position: | 0 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Nazwy komputerów i nowe nazwy można przekazać do polecenia cmdlet Add-Computer.
Dane wyjściowe
Jeśli używasz parametru
Uwagi
- W programie Windows PowerShell 2.0
parametr Server kończy się niepowodzeniem nawet wtedy, gdy serwer jest obecny. W programie Windows PowerShell 3.0 implementacja parametru server jest zmieniana tak, aby działała niezawodnie.