Add-Computer

Modul:

Microsoft.PowerShell.Management Module

Adja hozzá a helyi számítógépet egy tartományhoz vagy munkacsoporthoz.

Szintaxis

Domain (Alapértelmezett)

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

Leírás

A Add-Computer parancsmag hozzáadja a helyi számítógépet vagy távoli számítógépeket egy tartományhoz vagy munkacsoporthoz, vagy áthelyezi őket egyik tartományból a másikba. Emellett tartományi fiókot is létrehoz, ha a számítógép fiók nélkül van hozzáadva a tartományhoz.

A parancsmag paramétereivel megadhat egy szervezeti egységet (szervezeti egység) és egy tartományvezérlőt, vagy nem biztonságos csatlakozást hajthat végre.

A parancs eredményeinek lekéréséhez használja a Részletes és PassThru paramétereket.

Példák

1. példa: Helyi számítógép hozzáadása tartományhoz, majd a számítógép újraindítása

Add-Computer -DomainName Domain01 -Restart

Ez a parancs hozzáadja a helyi számítógépet a Tartomány01 tartományhoz, majd újraindítja a számítógépet a módosítás hatékonyságának érdekében.

2. példa: Helyi számítógép hozzáadása munkacsoporthoz

Add-Computer -WorkgroupName WORKGROUP-A

Ez a parancs hozzáadja a helyi számítógépet a Workgroup-A munkacsoporthoz.

3. példa: Helyi számítógép hozzáadása tartományhoz

Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose

Ez a parancs hozzáadja a helyi számítógépet a Tartomány01 tartományhoz a Domain01\DC01 tartományvezérlő használatával.

A parancs a PassThru és Részletes paramétereket használja a parancs eredményeinek részletes információihoz.

4. példa: Helyi számítógép hozzáadása tartományhoz az OUPath paraméterrel

Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"

Ez a parancs hozzáadja a helyi számítógépet a Domain02 tartományhoz. Az OUPath paraméter használatával adja meg az új fiókok szervezeti egységét.

5. példa: Helyi számítógép hozzáadása tartományhoz hitelesítő adatokkal

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

Ez a parancs hozzáadja a Server01 számítógépet a Domain02 tartományhoz. A LocalCredential paramétert használja egy olyan felhasználói fiók megadásához, amely jogosult a Kiszolgáló01 számítógéphez való csatlakozásra. A Hitelesítő adatok paraméterrel határoz meg egy olyan felhasználói fiókot, amely jogosult számítógépek tartományhoz való csatlakoztatására. A Újraindítás paraméter használatával újraindítja a számítógépet az illesztési művelet befejeződése után, a Kényszerítés paraméter pedig letiltja a felhasználói megerősítési üzeneteket.

6. példa: Számítógépcsoport áthelyezése új tartományba

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

Ez a parancs áthelyezi a Server01 és Server02 számítógépeket, valamint a helyi számítógépet tartomány01-ből Domain02-be.

A LocalCredential paraméterrel határoz meg egy felhasználói fiókot, amely jogosult csatlakozni a három érintett számítógéphez. A UnjoinDomainCredential paraméterrel olyan felhasználói fiókot ad meg, amely engedéllyel rendelkezik arra, hogy a tartomány01 tartományból és a Hitelesítő adatok paraméterből olyan felhasználói fiókot adjon meg, amely engedéllyel rendelkezik a számítógépek Tartomány02 tartományhoz való csatlakoztatásához. A Újraindítás paramétert használja mind a három számítógép újraindításához az áthelyezés befejezése után.

7. példa: Számítógép áthelyezése új tartományba, és a számítógép nevének módosítása

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

Ez a parancs áthelyezi a Server01 számítógépet a Domain02 tartományba, és a gép nevét Server044-re módosítja.

A parancs az aktuális felhasználó hitelesítő adatait használja a Server01 számítógéphez való csatlakozáshoz, és az aktuális tartományból való csatlakozás megszüntetéséhez. A Hitelesítő adatok paraméterrel adja meg azt a felhasználói fiókot, amely jogosult a számítógép Tartomány02 tartományhoz való csatlakoztatására.

8. példa: Fájlban felsorolt számítógépek hozzáadása új tartományhoz

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

Ez a parancs hozzáadja a fájlban Servers.txt felsorolt számítógépeket a Domain02 tartományhoz. A Beállítások paramétert használja a Win9xUpgrade beállítás megadásához. Az Újraindítás paraméter az illesztési művelet befejeződése után újraindítja az összes újonnan hozzáadott számítógépet.

9. példa: Számítógép hozzáadása tartományhoz előre megadott számítógép hitelesítő adataival

Ezt az első parancsot egy rendszergazdának kell futtatnia egy olyan számítógépről, amely már csatlakozott a tartományhoz 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

Ez a parancskombináció egy új számítógépfiókot hoz létre előre definiált névvel és ideiglenes csatlakozási jelszóval egy tartományban egy meglévő tartományhoz csatlakoztatott számítógép használatával. Ezután az előre definiált névvel rendelkező számítógép külön csatlakozik a tartományhoz csak a számítógépnév és az ideiglenes illesztés jelszava használatával. Az előre definiált jelszó csak az illesztési művelet támogatására szolgál, és a normál számítógépfiók-eljárások részeként váltja fel, miután a számítógép befejezte az illesztéseket.

10. példa: Számítógép hozzáadása új névvel rendelkező tartományhoz

Ha ezt a parancskombinációt használja, azzal elkerülheti a többszörös újraindítást, és több írást is az Active Directoryba ugyanarra az objektumra, amikor a számítógép az új névvel csatlakozik a tartományhoz.

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

Paraméterek

-ComputerName

Megadja a tartományhoz vagy munkacsoporthoz hozzáadni kívánt számítógépeket. Az alapértelmezett beállítás a helyi számítógép.

Írja be az egyes távoli számítógépek NetBIOS-nevét, IP-címét vagy teljes tartománynevét. A helyi számítógép megadásához írja be a számítógép nevét, egy pont (.) vagy egy "localhost" nevet.

Ez a paraméter nem támaszkodik a Windows PowerShell-újraegyezésre. A Add-Computer paraméterét akkor is használhatja, ha a számítógép nincs távoli parancsok futtatására konfigurálva.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	Local computer
Támogató vadkártyák:	False
Don't Show:	False

Paraméterhalmazok

(All)

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	True
Érték a csővezetékből az ingatlan név szerint:	True
Érték a maradék argumentumokból:	False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogató vadkártyák:	False
Don't Show:	False
Aliasok:	Cf

Paraméterhalmazok

(All)

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-Credential

Olyan felhasználói fiókot ad meg, amely engedéllyel rendelkezik a számítógépek új tartományhoz való csatlakoztatására. Az alapértelmezett az aktuális felhasználó.

Írjon be egy felhasználónevet (például "User01" vagy "Domain01\User01"), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot. Ha felhasználónevet ír be, a rendszer jelszót fog kérni.

Ha olyan felhasználói fiókot szeretne megadni, amely jogosult a számítógép aktuális tartományból való eltávolítására, használja a UnjoinDomainCredential paramétert. Ha olyan felhasználói fiókot szeretne megadni, amely engedéllyel rendelkezik a távoli számítógéphez való csatlakozáshoz, használja a LocalCredential paramétert.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	None
Támogató vadkártyák:	False
Don't Show:	False
Aliasok:	DomainCredential

Paraméterhalmazok

Domain

Pozíció:	Named
Kötelező:	True
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

Workgroup

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-DomainName

Azt a tartományt adja meg, amelyhez a számítógépeket hozzáadja. Ez a paraméter szükséges a számítógépek tartományhoz való hozzáadásakor.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogató vadkártyák:	False
Don't Show:	False
Aliasok:	DN, Szakterület

Paraméterhalmazok

Domain

Pozíció:	0
Kötelező:	True
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-Force

Letiltja a felhasználói megerősítési kérést. E paraméter nélkül Add-Computer minden számítógép hozzáadását meg kell erősítenie.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogató vadkártyák:	False
Don't Show:	False

Paraméterhalmazok

(All)

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-LocalCredential

A ComputerName paraméter által megadott számítógépekhez való csatlakozáshoz engedéllyel rendelkező felhasználói fiókot ad meg. Az alapértelmezett az aktuális felhasználó.

Írjon be egy felhasználónevet (például "User01" vagy "Domain01\User01"), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot. Ha felhasználónevet ír be, a rendszer jelszót fog kérni.

Ha olyan felhasználói fiókot szeretne megadni, amely rendelkezik engedéllyel a számítógépek új tartományhoz való hozzáadásához, használja a Hitelesítő adatok paramétert. Ha olyan felhasználói fiókot szeretne megadni, amely jogosult a számítógépek eltávolítására az aktuális tartományból, használja a UnjoinDomainCredential paramétert.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	Current user
Támogató vadkártyák:	False
Don't Show:	False

Paraméterhalmazok

(All)

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-NewName

Új nevet ad meg az új tartományban lévő számítógépnek. Ez a paraméter csak akkor érvényes, ha egy számítógépet adnak hozzá vagy helyeznek át.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogató vadkártyák:	False
Don't Show:	False

Paraméterhalmazok

(All)

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	True
Érték a maradék argumentumokból:	False

-Options

Az illesztési művelet speciális beállításait Add-Computer adja meg. Adjon meg egy vagy több értéket egy vesszővel tagolt sztringben.

A paraméter elfogadható értékei a következők:

• AccountCreate: Tartományi fiókot hoz létre. A Add-Computer parancsmag automatikusan létrehoz egy tartományi fiókot, amikor számítógépet ad hozzá egy tartományhoz. Ez a lehetőség a teljesség érdekében is elérhető.

• Win9XUpgrade: Azt jelzi, hogy az illesztési művelet a Windows operációs rendszer frissítésének része.

• UnsecuredJoin: Nem biztonságos illesztés végrehajtása. Nem biztonságos illesztés kéréséhez használja a Nem biztonságos paramétert vagy ezt a beállítást. Ha gépi jelszót szeretne megadni, akkor ezt a lehetőséget a beállítással PasswordPass együtt kell használnia.

• PasswordPass: A számítógép jelszavát a Hitelesítő adatok(DomainCredential) paraméter értékére állítja be a nem biztonságos illesztés végrehajtása után. Ez a beállítás azt is jelzi, hogy a Hitelesítő adatok (DomainCredential) paraméter értéke gépi jelszó, nem pedig felhasználói jelszó. Ez a beállítás csak akkor érvényes, ha a UnsecuredJoin beállítás meg van adva. Ha ezt a beállítást használja, a paraméterhez megadott hitelesítő adatoknak -Credential null felhasználónévvel kell rendelkezniük.

• JoinWithNewName: Átnevezi az új tartomány számítógépnevét a NewName paraméter által megadott névre. Ha a NewName paramétert használja, ez a beállítás automatikusan be van állítva. Ez a beállítás a Rename-Computer parancsmaggal való használatra lett tervezve. Ha a Rename-Computer parancsmaggal átnevezi a számítógépet, de a módosítás hatékonyabbá tétele érdekében nem indítja újra a számítógépet, ezzel a paraméterrel csatlakozhat a számítógéphez az új nevével rendelkező tartományhoz.

• JoinReadOnly: Meglévő számítógépfiókot használ a számítógép írásvédett tartományvezérlőhöz való csatlakoztatásához. A számítógépfiókot hozzá kell adni a jelszóreplikációs házirend engedélyezett listájához, és a fiók jelszavát a csatlakozás előtt replikálni kell az írásvédett tartományvezérlőre.

• InstallInvoke: Beállítja a JoinDomainOrWorkgroup metódus FJoinOptions paraméter ének létrehozási (0x2) és törlési (0x4) jelzőit. A JoinDomainOrWorkgroup metódusról további információt a Win32_ComputerSystem osztály JoinDomainOrWorkgroup metódusában talál. Ezekről a lehetőségekről további információt a NetJoinDomain függvényben talál.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	JoinOptions
Alapértelmezett érték:	None
Elfogadott értékek:	AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke
Támogató vadkártyák:	False
Don't Show:	False

Paraméterhalmazok

Domain

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-OUPath

A tartományi fiók szervezeti egységét (OU) adja meg. Írja be a szervezeti egység teljes megkülönböztető nevét idézőjelek közé. Az alapértelmezett érték a tartomány gépi objektumainak alapértelmezett szervezeti egysége.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogató vadkártyák:	False
Don't Show:	False
Aliasok:	OU

Paraméterhalmazok

Domain

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-PassThru

Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogató vadkártyák:	False
Don't Show:	False

Paraméterhalmazok

(All)

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-Restart

Újraindítja a tartományhoz vagy munkacsoporthoz hozzáadott számítógépeket. A módosítás hatékonyságának eléréséhez gyakran szükség van újraindításra.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogató vadkártyák:	False
Don't Show:	False

Paraméterhalmazok

(All)

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-Server

Megadja annak a tartományvezérlőnek a nevét, amely hozzáadja a számítógépet a tartományhoz. Adja meg a nevet teljes tartománynév formátumban. Alapértelmezés szerint nincs megadva tartományvezérlő.

2024 augusztusától kezdődően a tartományhoz való csatlakozás biztonsági megkeményedéséhez a tartományvezérlő teljes tartománynevét kell használnia. Például: DC1.contoso.com. További információ: NetJoin Domain Join Hardening Changes.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogató vadkártyák:	False
Don't Show:	False
Aliasok:	DC

Paraméterhalmazok

Domain

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-UnjoinDomainCredential

Olyan felhasználói fiókot ad meg, amely jogosult a számítógépek eltávolítására az aktuális tartományból. Az alapértelmezett az aktuális felhasználó.

Írjon be egy felhasználónevet (például "User01" vagy "Domain01\User01"), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által létrehozott objektumot. Ha felhasználónevet ír be, a rendszer jelszót fog kérni.

Ezt a paramétert akkor használja, ha a számítógépeket egy másik tartományba helyezi át. Ha olyan felhasználói fiókot szeretne megadni, amely jogosult az új tartományhoz való csatlakozásra, használja a Hitelesítő adatok paramétert. Ha olyan felhasználói fiókot szeretne megadni, amely engedéllyel rendelkezik a távoli számítógéphez való csatlakozáshoz, használja a LocalCredential paramétert.

Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	None
Támogató vadkártyák:	False
Don't Show:	False

Paraméterhalmazok

Domain

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-Unsecure

Nem biztonságos illesztés végrehajtása a megadott tartományhoz.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogató vadkártyák:	False
Don't Show:	False

Paraméterhalmazok

Domain

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogató vadkártyák:	False
Don't Show:	False
Aliasok:	Wi

Paraméterhalmazok

(All)

Pozíció:	Named
Kötelező:	False
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

-WorkgroupName

Megadja annak a munkacsoportnak a nevét, amelyhez a számítógépeket hozzáadják. Az alapértelmezett érték a "WORKGROUP".

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogató vadkártyák:	False
Don't Show:	False
Aliasok:	WGN

Paraméterhalmazok

Workgroup

Pozíció:	0
Kötelező:	True
Érték a csővezetékből:	False
Érték a csővezetékből az ingatlan név szerint:	False
Érték a maradék argumentumokból:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bemenetek

String

A számítógépneveket és az új neveket a Add-Computer parancsmagba is beszűkítheti.

Kimenetek

ComputerChangeInfo

Ha a PassThru paramétert használja, Add-Computer egy ComputerChangeInfo objektumot ad vissza. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.

Notes

• A Windows PowerShell 2.0-ban a serverAdd-Computer paramétere akkor is meghiúsul, ha a kiszolgáló jelen van. A Windows PowerShell 3.0-ban a Server paraméter implementációja módosul, hogy megbízhatóan működjön.

Kapcsolódó hivatkozások

• Checkpoint-Computer
• Számítógép eltávolítása
• Számítógép újraindítása
• Számítógép átnevezése
• Számítógép-helyreállítás
• Számítógép leállítása
• Kapcsolat tesztelése