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 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 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 Podrobné 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. Pomocí parametru LocalCredential určí uživatelský účet, který má oprávnění k připojení k počítači Server01. Pomocí parametru Credential určuje uživatelský účet, 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.
Pomocí parametru LocalCredential určí uživatelský účet, který má oprávnění připojit se ke třem ovlivněným počítačům. Pomocí parametru UnjoinDomainCredential určuje uživatelský účet, který má oprávnění k odpojování počítačů z domény Domain01 a parametru Credential k zadání uživatelského účtu s oprávněním 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 určí 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 Servers.txt souboru do domény Domain02. Používá parametr Options k určení možnosti Win9xUpgrade . Po dokončení operace připojení restartuje parametr Restart všechny nově přidané počítače.
Příklad 9: Přidání počítače do domény pomocí předdefinovaných přihlašovacích údajů počítače
Tento první příkaz by měl spustit správce z počítače, který je již připojený k doméně 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 $joinCredTato kombinace příkazů vytvoří nový účet počítače s předdefinovaným názvem a dočasným heslem pro připojení k doméně pomocí existujícího počítače připojeného k doméně. Počítač s předdefinovaným názvem se pak připojí k doméně pouze pomocí názvu počítače a dočasného hesla pro připojení. Předdefinované heslo se používá pouze k podpoře operace spojení a po dokončení spojení se nahradí jako součást běžných postupů účtu počítače.
Parametry
-ComputerName
Určuje počítače, které se mají přidat do domény nebo pracovní skupiny. Ve výchozím nastavení je to 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 ComputerNameAdd-Computer můžete použít i v případě, že počítač není nakonfigurovaný tak, aby spouštět vzdálené příkazy.
Tento parametr je zavedený ve Windows PowerShellu 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: | None |
| 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 je nutné potvrdit přidání každého počítače.
Tento parametr je zavedený ve Windows PowerShellu 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 aktuální domény, použijte parametr UnjoinDomainCredential .
Tento parametr je zavedený ve Windows PowerShellu 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ý pouze v případě, že se přidává nebo přesouvá jeden počítač.
Tento parametr je zavedený ve Windows PowerShellu 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 Add-Computer spojení. 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-Computerautomaticky 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í. Chcete-li požádat o nezabezpečené spojení, použijte nezabezpečený parametr nebo tuto možnost. Pokud chcete předat heslo počítače, musíte tuto možnost použít v kombinaci s
PasswordPassmož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á pouze v případě, že je zadána
UnsecuredJoinmožnost. Při použití této možnosti musí přihlašovací údaje zadané parametru-Credentialobsahovat uživatelské jméno s hodnotou null.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
Rename-Computerrutinu, 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 pro 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) parametru FJoinOptions metody JoinDomainOrWorkgroup. Další informace o JoinDomainOrWorkgroup metoda, viz JoinDomainOrWorkgroup metoda Win32_ComputerSystem třídy. Další informace o těchto možnostech naleznete v tématu NetJoinDomain funkce.
Tento parametr byl představen ve Windows PowerShellu 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: | None |
| 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: | None |
| 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ý ve Windows PowerShellu 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 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ý ve Windows PowerShellu 3.0.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Unsecure
Provede nezabezpečené připojení k zadané doméně.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 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
Názvy počítačů a nové názvy můžete generovat rutině Add-Computer .
Výstupy
Při použití PassThru parametr, Add-Computer vrátí ComputerChangeInfo objekt.
Jinak tato rutina negeneruje žádný výstup.
Poznámky
- V prostředí Windows PowerShell 2.0 parametr
Add-ComputerServeru selže i v případě, že server existuje. Ve Windows PowerShellu 3.0 se implementace parametru Serveru změní tak, aby spolehlivě fungovala.
Související odkazy
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro