Add-Computer
Přidejte místní počítač do domény nebo pracovní skupiny.
Syntax
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 druhé.
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í.
K získání výsledků příkazu použijte parametry Verbose 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 pracovní skupiny Workgroup-A.
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á parametry PassThru a Verbose 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. Pomocí parametru OUPath určí organizační jednotku pro nové účty.
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í k 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ě. Po dokončení operace spojení pomocí parametru Restart restartuje počítač a parametr Force potlačuje potvrzovací zprávy 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.
Používá parametr LocalCredential k určení uživatelského účtu, který má oprávnění pro připojení ke třem ovlivněným počítačům. Pomocí parametru UnjoinDomainCredential zadá uživatelský účet, který má oprávnění k zrušení spojení počítačů z domény Domain01 a parametru Credential k zadání uživatelského účtu, který má oprávnění připojit počítače k doméně Domain02. Po dokončení přesunu pomocí parametru Restart restartuje 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. Pomocí parametru Credential zadá uživatelský účet, 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. Používá parametr Options k určení možnosti Win9xUpgrade . Parametr Restart restartuje všechny nově přidané počítače po dokončení operace připojení.
Parametry
-ComputerName
Určuje počítače, které se mají přidat do domény nebo pracovní skupiny. Výchozí hodnotou je místní počítač.
Zadejte název NetBIOS, IP adresu (Internet Protocol) nebo plně kvalifikovaný název domény všech vzdálených počítačů. Pokud chcete zadat místní počítač, zadejte název počítače, tečku (.) nebo localhost.
Tento parametr nespoléhá na Windows PowerShell vzdálené komunikace.
Parametr Add-ComputerComputerName můžete použít i v případě, že počítač není nakonfigurovaný ke spouštění vzdálených příkazů.
Tento parametr je zaveden v Windows PowerShell 3.0.
| Type: | String[] |
| Position: | Named |
| Default value: | Local computer |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Určuje uživatelský účet, který má oprávnění připojit počítače k nové doméně. Ve výchozím nastavení je to aktuální uživatel.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential , 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 .
| Type: | PSCredential |
| Aliases: | DomainCredential |
| Position: | Named |
| Default value: | Current User Account Credentials |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Aliases: | DN, Domain |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Potlačí výzvu k potvrzení uživatele.
Bez tohoto parametru Add-Computer musíte potvrdit přidání jednotlivých počítačů.
Tento parametr je zaveden v Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LocalCredential
Určuje uživatelský účet, který má oprávnění pro připojení k počítačům určeným parametrem ComputerName . Ve výchozím nastavení je to aktuální uživatel.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential , 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 Credential . Chcete-li zadat uživatelský účet, který má oprávnění k odebrání počítačů z jejich aktuální domény, použijte parametr UnjoinDomainCredential .
Tento parametr je zaveden v Windows PowerShell 3.0.
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Určuje nový název počítače v nové doméně. Tento parametr je platný jenom v případě, že se přidává nebo přesouvá jeden počítač.
Tento parametr je zaveden v Windows PowerShell 3.0.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Options
Určuje upřesňující možnosti operace spojení doplňku počítače . Do řetězce odděleného čárkami zadejte jednu nebo více hodnot.
Tento parametr přijímá tyto hodnoty:
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 nezabezpečený parametr nebo tuto možnost.
PasswordPass: Nastaví heslo počítače na hodnotu parametru Credential(DomainCredential) po provedení nezabezpečeného spojení. 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á jenom v případě, že je zadána možnost Nezabezpečenéjoin.
-- 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 zásad replikace hesel a heslo účtu musí být replikováno do řadiče domény jen pro čtení před operací připojení.
InstallInvoke: Nastaví příznaky create (0x2) a delete (0x4) parametru FJoinOptions metody JoinDomainOrWorkgroup . 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 naleznete v tématu NetJoinDomain funkce v knihovně MSDN.
Tento parametr byl zaveden v 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
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ě.
| Type: | String |
| Aliases: | OU |
| Position: | Named |
| Default value: | The default OU for machine objects for in the domain |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 v Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Aliases: | DC |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnjoinDomainCredential
Určuje uživatelský účet, který má oprávnění k odebrání počítačů z jejich aktuálních domén. Ve výchozím nastavení je to aktuální uživatel.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential , 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 Credential . 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 v Windows PowerShell 3.0.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Unsecure
Provede nezabezpečené spojení se zadanou doménou.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkgroupName
Určuje název pracovní skupiny, do které se počítače přidají. Výchozí hodnota je "WORKGROUP".
| Type: | String |
| Aliases: | WGN |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Vstupy
Do rutiny Add-Computer můžete generovat názvy počítačů a nové názvy.
Výstupy
Pokud použijete parametr PassThru , Add-Computer vrátí ComputerChangeInfo objekt.
Jinak tato rutina negeneruje žádný výstup.
Poznámky
- V Windows PowerShell 2.0 parametr
Add-ComputerServeru selže i v případě, že server existuje. V Windows PowerShell 3.0 se implementace parametru Serveru změní tak, aby fungovala spolehlivě.