Add-Computer
Přidejte místní počítač do domény nebo pracovní skupiny.
Syntax
Domain (Výchozí)
Add-Computer
[-DomainName] <String>
-Credential <PSCredential>
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-UnjoinDomainCredential <PSCredential>]
[-OUPath <String>]
[-Server <String>]
[-Unsecure]
[-Options <JoinOptions>]
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Workgroup
Add-Computer
[-WorkgroupName] <String>
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-Credential <PSCredential>]
[-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 -Restart
Tento 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-A
Tento 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 -Verbose
Tento 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 -Force
Tento 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 -Restart
Tento 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 -Restart
Tento 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 -Restart
Tento 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 ComputerName můžete použít v rámci Add-Computer, i když váš počítač není nakonfigurován pro spouštění vzdálených příkazů.
Tento parametr je zavedený ve Windows PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | Local computer |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | Current User Account Credentials |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | DomainCredential |
Sady parametrů
Workgroup
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | DN, Domain (Doména) |
Sady parametrů
Domain
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | Current user |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | JoinOptions |
| Default value: | None |
| Přípustné hodnoty: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Domain
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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ě.
Vlastnosti parametru
| Typ: | String |
| Default value: | The default OU for machine objects for in the domain |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | OU |
Sady parametrů
Domain
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Stejnosměrný proud |
Sady parametrů
Domain
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Domain
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Unsecure
Provede nezabezpečené připojení k zadané doméně.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Domain
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WorkgroupName
Určuje název pracovní skupiny, do které se počítače přidají. Výchozí hodnota je WORKGROUP.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | WGN |
Sady parametrů
Workgroup
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Názvy počítačů a nové názvy můžete generovat do rutiny Add-Computer.
Výstupy
ComputerChangeInfo
Pokud použijete parametr PassThru, Add-Computer vrátí objekt ComputerChangeInfo.
Jinak tento příkaz 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.