Add-Computer

Odwołanie

Moduł:: Microsoft.PowerShell.Management

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 Domain01\DC01 kontrolera domeny.

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ń

$addComputerSplat = @{
    ComputerName = 'Server01'
    LocalCredential = 'Server01\Admin01'
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Restart = $true
    Force = $true
}
Add-Computer @addComputerSplat

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

$addComputerSplat = @{
    ComputerName = 'Server01', 'Server02', 'localhost'
    DomainName = 'Domain02'
    LocalCredential = 'Domain01\User01'
    UnjoinDomainCredential = 'Domain01\Admin01'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

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

$addComputerSplat = @{
    ComputerName = 'Server01'
    DomainName = 'Domain02'
    NewName = 'Server044'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

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

$addComputerSplat = @{
    ComputerName = (Get-Content Servers.txt)
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Options = 'Win9xUpgrade'
    Restart = $true
}
Add-Computer @addComputerSplat

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:

$newADComputerSplat = @{
    Name = "Server02"
    AccountPassword = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
}
New-ADComputer @newADComputerSplat

# 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]
})
$addComputerSplat = @{
    DomainName = "Domain03"
    Options = 'UnsecuredJoin', 'PasswordPass'
    Credential = $joinCred
}
Add-Computer @addComputerSplat

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.

Przykład 10: Dodawanie komputera do domeny o nowej nazwie

Użycie tej kombinacji poleceń pozwala uniknąć wielu ponownych uruchomień i wielu zapisów w usłudze Active Directory zapisu dla tego samego obiektu, gdy komputer przyłącza domenę do nowej nazwy.

Rename-Computer -NewName "MyNewPC" -Force
$addComputerSplat = @{
    DomainName = 'Contoso.com'
    Credential = 'contoso\administrator'
    Options = 'JoinWithNewName', 'AccountCreate'
}
Add-Computer @addComputerSplat

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.

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 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 .

Typ:	PSCredential
Aliasy:	DomainCredential
Position:	Named
Domyślna wartość:	None
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 należy potwierdzić dodanie 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 użytkownik bieżący.

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 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.

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ść:	None
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ść:	None
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 użytkownik bieżący.

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ść:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. 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

-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

String

Nazwy komputerów i nowe nazwy można potokować do Add-Computer polecenia cmdlet.

Dane wyjściowe

ComputerChangeInfo

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.

Udostępnij za pośrednictwem

Add-Computer

Składnia

Opis

Przykłady

Przykład 1: Dodawanie komputera lokalnego do domeny, a następnie ponowne uruchomienie komputera

Przykład 2. Dodawanie komputera lokalnego do grupy roboczej

Przykład 3. Dodawanie komputera lokalnego do domeny

Przykład 4. Dodawanie komputera lokalnego do domeny przy użyciu parametru OUPath

Przykład 5. Dodawanie komputera lokalnego do domeny przy użyciu poświadczeń

Przykład 6. Przenoszenie grupy komputerów do nowej domeny

Przykład 7: Przenoszenie komputera do nowej domeny i zmienianie nazwy komputera

Przykład 8. Dodawanie komputerów wymienionych w pliku do nowej domeny

Przykład 9. Dodawanie komputera do domeny przy użyciu wstępnie zdefiniowanych poświadczeń komputera

Przykład 10: Dodawanie komputera do domeny o nowej nazwie

Parametry

-ComputerName

-Confirm

-Credential

-DomainName

-Force

-LocalCredential

-NewName

-Options

-OUPath

-PassThru

-Restart

-Server

-UnjoinDomainCredential

-Unsecure

-WhatIf

-WorkgroupName

Dane wejściowe

Dane wyjściowe

Uwagi

Dodatkowe zasoby

Udostępnij za pośrednictwem

Add-Computer

Składnia

Opis

Przykłady

Przykład 1: Dodawanie komputera lokalnego do domeny, a następnie ponowne uruchomienie komputera

Przykład 2. Dodawanie komputera lokalnego do grupy roboczej

Przykład 3. Dodawanie komputera lokalnego do domeny

Przykład 4. Dodawanie komputera lokalnego do domeny przy użyciu parametru OUPath

Przykład 5. Dodawanie komputera lokalnego do domeny przy użyciu poświadczeń

Przykład 6. Przenoszenie grupy komputerów do nowej domeny

Przykład 7: Przenoszenie komputera do nowej domeny i zmienianie nazwy komputera

Przykład 8. Dodawanie komputerów wymienionych w pliku do nowej domeny

Przykład 9. Dodawanie komputera do domeny przy użyciu wstępnie zdefiniowanych poświadczeń komputera

Przykład 10: Dodawanie komputera do domeny o nowej nazwie

Parametry

-ComputerName

-Confirm

-Credential

-DomainName

-Force

-LocalCredential

-NewName

-Options

-OUPath

-PassThru

-Restart

-Server

-UnjoinDomainCredential

-Unsecure

-WhatIf

-WorkgroupName

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Dodatkowe zasoby