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 Add-Computer
cmdlet 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 -Restart
To 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-A
To 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 -Verbose
To polecenie dodaje komputer lokalny do domeny Domain01 przy użyciu kontrolera domeny Domain01\DC01.
Polecenie używa parametrów PassThru i Verbose , 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 -Force
To 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 do określenia konta użytkownika, które ma uprawnienia do dołączania komputerów do domeny. Używa parametru Restart w celu ponownego uruchomienia komputera po zakończeniu operacji sprzężenia i parametru Force w celu pomijania komunikatów 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 -Restart
To 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 do określenia konta 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 parametru Restart do ponownego uruchomienia wszystkich trzech komputerów 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 -Restart
To 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 do określenia konta 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 -Restart
To polecenie dodaje komputery wymienione w Servers.txt
pliku do domeny Domain02. Używa parametru Opcje , aby określić opcję Win9xUpgrade . Parametr Restart powoduje ponowne uruchomienie wszystkich nowo dodanych komputerów po zakończeniu operacji sprzężenia.
Przykład 9. Dodawanie komputera do domeny przy użyciu wstępnie zdefiniowanych poświadczeń komputera
To pierwsze polecenie powinno być uruchamiane przez administratora z komputera, który jest już przyłączony do domeny Domain03
:
New-ADComputer -Name "Server02" -AccountPassword (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
# Then this command is run from `Server02` which is not yet domain-joined:
$joinCred = New-Object pscredential -ArgumentList ([pscustomobject]@{
UserName = $null
Password = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)[0]
})
Add-Computer -Domain "Domain03" -Options UnsecuredJoin,PasswordPass -Credential $joinCred
Ta kombinacja poleceń tworzy nowe konto komputera ze wstępnie zdefiniowaną nazwą i tymczasowym hasłem sprzężenia w domenie przy użyciu istniejącego komputera przyłączonego do domeny. Następnie komputer ze wstępnie zdefiniowaną nazwą przyłącza domenę tylko przy użyciu nazwy komputera i tymczasowego hasła sprzężenia. Wstępnie zdefiniowane hasło jest używane tylko do obsługi operacji sprzężenia i jest zastępowane w ramach normalnych procedur konta komputera po zakończeniu sprzężenia przez komputer.
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 Add-Computer
ComputerName, nawet jeśli komputer nie jest skonfigurowany do uruchamiania poleceń zdalnych.
Ten parametr jest wprowadzany w programie Windows PowerShell 3.0.
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 |
-Credential
Określa konto użytkownika, które ma uprawnienia do dołączania komputerów do nowej domeny. 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, zostanie wyświetlony monit o podanie hasła.
Aby określić konto użytkownika, które ma uprawnienia do usunięcia 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 .
Type: | PSCredential |
Aliases: | DomainCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainName
Określa domenę, do której są dodawane komputery. Ten parametr jest wymagany podczas dodawania komputerów do domeny.
Type: | String |
Aliases: | DN, Domain |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Pomija monit o potwierdzenie użytkownika. Bez tego parametru Add-Computer
należy potwierdzić dodanie każdego komputera.
Ten parametr jest wprowadzany w programie Windows PowerShell 3.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 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, 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.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Options
Określa zaawansowane opcje operacji sprzężenia Add-Computer
. Wprowadź co najmniej jedną wartość w ciągu rozdzielanym przecinkami.
Dopuszczalne wartości tego parametru to:
AccountCreate: tworzy konto domeny. Polecenie
Add-Computer
cmdlet 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.
NiezabezpieczoneJoin: wykonuje niezabezpieczone sprzężenia. Aby zażądać niezabezpieczonego sprzężenia, użyj niezabezpieczonego parametru lub tej opcji. Jeśli chcesz przekazać hasło maszyny, musisz użyć tej opcji w połączeniu z opcją
PasswordPass
.PasswordPass: ustawia hasło maszyny na wartość parametru Credential(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 jest określona
UnsecuredJoin
opcja. W przypadku korzystania z tej opcji poświadczenie podane do parametru-Credential
musi mieć nazwę użytkownika o wartości null.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
Rename-Computer
polecenia cmdlet do zmiany nazwy komputera, ale nie uruchamiaj ponownie komputera, aby wprowadzić zmianę obowiązującą, 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) parametru FJoinOptions metody JoinDomainOrWorkgroup. Aby uzyskać więcej informacji na temat metody JoinDomainOrWorkgroup, zobacz JoinDomainOrWorkgroup method of the Win32_ComputerSystem class (Metoda JoinDomainOrWorkgroup). Aby uzyskać więcej informacji na temat tych opcji, zobacz Funkcja NetJoinDomain.
Ten parametr został wprowadzony w programie Windows PowerShell 3.0.
Type: | JoinOptions |
Accepted values: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Aliases: | OU |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie 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
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Aliases: | DC |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnjoinDomainCredential
Określa konto użytkownika, które ma uprawnienia do usuwania komputerów z ich bieżących domen. 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, 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.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Unsecure
Wykonuje niezabezpieczone sprzężenie do określonej domeny.
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 |
-WorkgroupName
Określa nazwę grupy roboczej, do której są dodawane komputery. Wartość domyślna to "WORKGROUP".
Type: | String |
Aliases: | WGN |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Dane wejściowe
Nazwy komputerów i nowe nazwy można potokować do Add-Computer
polecenia cmdlet.
Dane wyjściowe
Gdy używasz parametru PassThru , Add-Computer
zwraca obiekt ComputerChangeInfo .
W przeciwnym razie to polecenie cmdlet nie generuje żadnych danych wyjściowych.
Uwagi
- W programie Windows PowerShell 2.0 parametr
Add-Computer
Serwera kończy się niepowodzeniem nawet wtedy, gdy serwer jest obecny. W programie Windows PowerShell 3.0 implementacja parametru Serwera jest zmieniana tak, aby działała niezawodnie.
Linki powiązane
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla