Add-Computer
Přidejte místní počítač do domény nebo pracovní skupiny.
Syntaxe
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>]Description
Rutina Add-Computer přidá místní počítač nebo vzdálené počítače do domény nebo pracovní skupiny nebo je přesune z jedné domény do jiné.
Vytvoří také účet domény, pokud se počítač přidá do domény bez účtu.
Parametry této rutiny můžete použít k určení organizační jednotky (OU) a řadiče domény nebo k provedení nezabezpečeného spojení.
Pokud chcete získat výsledky příkazu, použijte parametry Podrobné a PassThru.
Příklady
Příklad 1: Přidání místního počítače do domény a následné restartování počítače
Add-Computer -DomainName Domain01 -RestartTento příkaz přidá místní počítač do domény Domain01 a restartuje počítač, aby se změna projevila.
Příklad 2: Přidání místního počítače do pracovní skupiny
Add-Computer -WorkgroupName WORKGROUP-ATento příkaz přidá místní počítač do Workgroup-A pracovní skupiny.
Příklad 3: Přidání místního počítače do domény
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -VerboseTento příkaz přidá místní počítač do domény Domain01 pomocí řadiče domény Domain01\DC01.
Příkaz používá PassThru a podrobné parametry k získání podrobných informací o výsledcích příkazu.
Příklad 4: Přidání místního počítače do domény pomocí parametru OUPath
Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"Tento příkaz přidá místní počítač do domény Domain02. K určení organizační jednotky pro nové účty používá parametr OUPath.
Příklad 5: Přidání místního počítače do domény pomocí přihlašovacích údajů
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -ForceTento příkaz přidá počítač Server01 do domény Domain02. Používá parametr LocalCredential k určení uživatelského účtu, který má oprávnění pro připojení k počítači Server01. Používá parametr Credential k určení uživatelského účtu, který má oprávnění připojit počítače k doméně. Používá parametr Restart k restartování počítače po dokončení operace spojení a parametr Vynucení k potlačení potvrzovacích zpráv uživatele.
Příklad 6: Přesunutí skupiny počítačů do nové domény
Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -RestartTento příkaz přesune počítače Server01 a Server02 a místní počítač z Domain01 do Domain02.
Pomocí parametru LocalCredential určuje uživatelský účet s oprávněním připojit se ke třem ovlivněným počítačům. Používá UnjoinDomainCredential parametr k určení uživatelského účtu, který má oprávnění k odpojování počítačů z domény Domain01 a parametr Credential zadat uživatelský účet, který má oprávnění připojit počítače k doméně Domain02. Po dokončení přesunu používá parametr Restart restartovat všechny tři počítače.
Příklad 7: Přesunutí počítače do nové domény a změna názvu počítače
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -RestartTento příkaz přesune počítač Server01 do domény Domain02 a změní název počítače na Server044.
Příkaz používá přihlašovací údaje aktuálního uživatele pro připojení k počítači Server01 a jeho spojení z jeho aktuální domény. Používá parametr credential k určení uživatelského účtu, který má oprávnění připojit počítač k doméně Domain02.
Příklad 8: Přidání počítačů uvedených v souboru do nové domény
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -RestartTento příkaz přidá počítače uvedené v souboru Servers.txt do domény Domain02. Pomocí parametru Options určuje možnost Win9xUpgrade. Parametr Restartovat po dokončení operace spojení restartuje všechny nově přidané počítače.
Parametry
-ComputerName
Určuje počítače, které se mají přidat do domény nebo pracovní skupiny. Výchozí hodnota je místní počítač.
Zadejte název NetBIOS, IP adresu (Internet Protocol) nebo plně kvalifikovaný název domény každého ze vzdálených počítačů. Chcete-li zadat místní počítač, zadejte název počítače, tečku (.) nebo "localhost".
Tento parametr nespoléhá na vzdálené komunikace Windows PowerShellu.
Parametr
Tento parametr je zavedený ve Windows PowerShellu 3.0.
| Typ: | String[] |
| Position: | Named |
| Default value: | Local computer |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny vás vyzve k potvrzení.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Credential
Určuje uživatelský účet, který má oprávnění připojit počítače k nové doméně. Výchozí hodnota je aktuální uživatel.
Zadejte uživatelské jméno, například "User01" nebo "Domain01\User01", nebo zadejte PSCredential objekt, například objekt vygenerovaný rutinou Get-Credential.
Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.
Chcete-li zadat uživatelský účet, který má oprávnění k odebrání počítače z jeho aktuální domény, použijte parametr UnjoinDomainCredential. Chcete-li zadat uživatelský účet, který má oprávnění pro připojení ke vzdálenému počítači, použijte parametr LocalCredential.
| Typ: | PSCredential |
| Aliasy: | DomainCredential |
| Position: | Named |
| Default value: | Current User Account Credentials |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DomainName
Určuje doménu, do které se počítače přidají. Tento parametr se vyžaduje při přidávání počítačů do domény.
| Typ: | String |
| Aliasy: | DN, Domain |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Force
Potlačí výzvu k potvrzení uživatele.
Bez tohoto parametru Add-Computer vyžaduje potvrzení přidání každého počítače.
Tento parametr je zavedený ve Windows PowerShellu 3.0.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-LocalCredential
Určuje uživatelský účet, který má oprávnění pro připojení k počítačům určeným parametrem ComputerName. Výchozí hodnota je aktuální uživatel.
Zadejte uživatelské jméno, například "User01" nebo "Domain01\User01", nebo zadejte PSCredential objekt, například objekt vygenerovaný rutinou Get-Credential.
Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.
Pokud chcete zadat uživatelský účet, který má oprávnění k přidání počítačů do nové domény, použijte parametr přihlašovacích údajů. Pokud chcete zadat uživatelský účet, který má oprávnění k odebrání počítačů z aktuální domény, použijte parametr UnjoinDomainCredential.
Tento parametr je zavedený ve Windows PowerShellu 3.0.
| Typ: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-NewName
Určuje nový název počítače v nové doméně. Tento parametr je platný pouze v případě, že se přidává nebo přesouvá jeden počítač.
Tento parametr je zavedený ve Windows PowerShellu 3.0.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Options
Určuje upřesňující možnosti operace připojení add-computer join. Do řetězce odděleného čárkami zadejte jednu nebo více hodnot.
Přijatelné hodnoty pro tento parametr jsou:
AccountCreate: Vytvoří účet domény. Rutina Add-Computer automaticky vytvoří účet domény, když přidá počítač do domény. Tato možnost je zahrnuta pro úplnost.
Win9XUpgrade: Označuje, že operace spojení je součástí upgradu operačního systému Windows.
Nezabezpečenéjoin: Provede nezabezpečené spojení. Pokud chcete požádat o nezabezpečené spojení, použijte parametr Nezabezpečený nebo tuto možnost.
PasswordPass: Po provedení nezabezpečeného spojení nastaví heslo počítače na hodnotu parametru Credential(DomainCredential). Tato možnost také označuje, že hodnota parametru Credential (DomainCredential) je heslo počítače, nikoli uživatelské heslo. Tato možnost je platná pouze v případě, že je zadána možnost Nezabezpečená úloha.
-- JoinWithNewName: Přejmenuje název počítače v nové doméně na název zadaný parametrem NewName. Pokud použijete parametr NewName, tato možnost se nastaví automaticky. Tato možnost je navržená tak, aby se používala s rutinou Rename-Computer. Pokud k přejmenování počítače použijete rutinu Rename-Computer, ale nerestartujete počítač, aby se změna projevila, můžete tento parametr použít k připojení počítače k doméně s novým názvem.
JoinReadOnly: Používá existující účet počítače k připojení počítače k řadiči domény jen pro čtení. Účet počítače musí být přidán do seznamu povolených pro zásady replikace hesel a heslo účtu se musí replikovat do řadiče domény jen pro čtení před operací připojení.
InstallInvoke: Nastaví příznaky create (0x2) a delete (0x4) FJoinOptions parametru JoinDomainOrWorkgroup metody. Další informace o metodě JoinDomainOrWorkgroup naleznete v tématu JoinDomainOrWorkgroup metoda Win32_ComputerSystem třídy v knihovně MSDN. Další informace o těchto možnostech najdete v tématu Funkce NetJoinDomain v knihovně MSDN.
Tento parametr byl představen ve Windows PowerShellu 3.0.
| Typ: | JoinOptions |
| Přípustné hodnoty: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-OUPath
Určuje organizační jednotku (OU) pro účet domény. Do uvozovek zadejte úplný rozlišující název organizační jednotky. Výchozí hodnota je výchozí organizační jednotky pro objekty počítače v doméně.
| Typ: | String |
| Aliasy: | OU |
| Position: | Named |
| Default value: | The default OU for machine objects for in the domain |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PassThru
Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Restart
Restartuje počítače přidané do domény nebo pracovní skupiny. K efektivní změně se často vyžaduje restartování.
Tento parametr je zavedený ve Windows PowerShellu 3.0.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Server
Určuje název řadiče domény, který přidá počítač do domény. Zadejte název ve formátu DomainName\ComputerName. Ve výchozím nastavení není zadaný žádný řadič domény.
| Typ: | String |
| Aliasy: | DC |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-UnjoinDomainCredential
Určuje uživatelský účet, který má oprávnění k odebrání počítačů z aktuálních domén. Výchozí hodnota je aktuální uživatel.
Zadejte uživatelské jméno, například "User01" nebo "Domain01\User01", nebo zadejte PSCredential objekt, například objekt vygenerovaný rutinou Get-Credential.
Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.
Tento parametr použijte při přesouvání počítačů do jiné domény. Pokud chcete zadat uživatelský účet s oprávněním připojit se k nové doméně, použijte parametr přihlašovacích údajů. Chcete-li zadat uživatelský účet, který má oprávnění pro připojení ke vzdálenému počítači, použijte parametr LocalCredential.
Tento parametr je zavedený ve Windows PowerShellu 3.0.
| Typ: | PSCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Unsecure
Provede nezabezpečené připojení k zadané doméně.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-WorkgroupName
Určuje název pracovní skupiny, do které se počítače přidají. Výchozí hodnota je WORKGROUP.
| Typ: | String |
| Aliasy: | WGN |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
Názvy počítačů a nové názvy můžete generovat do rutiny Add-Computer.
Výstupy
Pokud použijete parametr PassThru, Add-Computer vrátí objekt ComputerChangeInfo.
Jinak tato rutina negeneruje žádný výstup.
Poznámky
- Ve Windows PowerShellu 2.0 selže parametr Serveru
Add-Computeri v případě, že je server k dispozici. Ve Windows PowerShellu 3.0 se změní implementace parametru Server tak, aby spolehlivě fungovala.