Add-Computer

Reference

Modul:: Microsoft.PowerShell.Management

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

Tento příkaz přidá místní počítač do domény Domain01 pomocí Domain01\DC01 řadiče domény.

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ů

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

Tento 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

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

Tento 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

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

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

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

Tento 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:

$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

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

Příklad 10: Přidání počítače do domény s novým názvem

Pomocí této kombinace příkazů se vyhnete několika restartováním a více zápisům do služby Active Directory pro stejný objekt, když se počítač připojí k doméně s novým názvem.

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

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

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 zobrazí výzvu 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ě. 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 .

Typ:	PSCredential
Aliasy:	DomainCredential
Position:	Named
Default value:	None
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 je nutné potvrdit 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 . Ve výchozím nastavení je to aktuální uživatel.

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.

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 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-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í. 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 PasswordPass 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á pouze v případě, že je zadána UnsecuredJoin možnost. Při použití této možnosti musí přihlašovací údaje zadané parametru -Credential obsahovat 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-Computer rutinu, 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.

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:	None
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:	None
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. Ve výchozím nastavení je to aktuální uživatel.

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.

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:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

String

Názvy počítačů a nové názvy můžete generovat rutině Add-Computer .

Výstupy

ComputerChangeInfo

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-Computer Serveru selže i v případě, že server existuje. Ve Windows PowerShellu 3.0 se implementace parametru Serveru změní tak, aby spolehlivě fungovala.

Sdílet prostřednictvím

Add-Computer

Syntaxe

Description

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

Příklad 2: Přidání místního počítače do pracovní skupiny

Příklad 3: Přidání místního počítače do domény

Příklad 4: Přidání místního počítače do domény pomocí parametru OUPath

Příklad 5: Přidání místního počítače do domény pomocí přihlašovacích údajů

Příklad 6: Přesunutí skupiny počítačů do nové domény

Příklad 7: Přesunutí počítače do nové domény a změna názvu počítače

Příklad 8: Přidání počítačů uvedených v souboru do nové domény

Příklad 9: Přidání počítače do domény pomocí předdefinovaných přihlašovacích údajů počítače

Příklad 10: Přidání počítače do domény s novým názvem

Parametry

-ComputerName

-Confirm

-Credential

-DomainName

-Force

-LocalCredential

-NewName

-Options

-OUPath

-PassThru

-Restart

-Server

-UnjoinDomainCredential

-Unsecure

-WhatIf

-WorkgroupName

Vstupy

Výstupy

Poznámky

Další materiály

Sdílet prostřednictvím

Add-Computer

Syntaxe

Description

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

Příklad 2: Přidání místního počítače do pracovní skupiny

Příklad 3: Přidání místního počítače do domény

Příklad 4: Přidání místního počítače do domény pomocí parametru OUPath

Příklad 5: Přidání místního počítače do domény pomocí přihlašovacích údajů

Příklad 6: Přesunutí skupiny počítačů do nové domény

Příklad 7: Přesunutí počítače do nové domény a změna názvu počítače

Příklad 8: Přidání počítačů uvedených v souboru do nové domény

Příklad 9: Přidání počítače do domény pomocí předdefinovaných přihlašovacích údajů počítače

Příklad 10: Přidání počítače do domény s novým názvem

Parametry

-ComputerName

-Confirm

-Credential

-DomainName

-Force

-LocalCredential

-NewName

-Options

-OUPath

-PassThru

-Restart

-Server

-UnjoinDomainCredential

-Unsecure

-WhatIf

-WorkgroupName

Vstupy

Výstupy

Poznámky

Související odkazy

Další materiály