Add-Computer
Adja hozzá a helyi számítógépet egy tartományhoz vagy munkacsoporthoz.
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
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 Verbose és a 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 az 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 a Részletes paraméterek használatával részletes információkat kap a parancs eredményeiről.
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
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -Force
Ez a parancs hozzáadja a Server01 számítógépet a Domain02 tartományhoz. A LocalCredential paraméterrel egy olyan felhasználói fiókot ad meg, amely jogosult csatlakozni a Server01 számítógéphez. A Hitelesítő adatok paraméterrel egy olyan felhasználói fiókot ad meg, amely jogosult számítógépek tartományhoz való csatlakoztatására. Az Újraindítás paraméter használatával újraindítja a számítógépet az illesztési művelet befejezése után, a Kényszerítés paraméter pedig letiltja a felhasználói megerősítést kérő üzeneteket.
6. példa: Számítógépcsoport áthelyezése új tartományba
Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -Restart
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 egy olyan felhasználói fiókot ad meg, amely jogosult csatlakozni a három érintett számítógéphez. Az UnjoinDomainCredential paraméterrel olyan felhasználói fiókot ad meg, amely rendelkezik engedéllyel a számítógépek Tartomány01 tartományból való csatlakozásának megszüntetéséhez, a Hitelesítő adatok paraméter pedig egy olyan felhasználói fiók megadásához, amely engedéllyel rendelkezik a számítógépek Tartomány02 tartományhoz való csatlakoztatására. Az Ú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
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -Restart
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 egy olyan felhasználói fiókot ad meg, 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
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -Restart
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éter használatával adja meg a Win9xUpgrade beállítást. 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
:
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 $joinCred
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.
Paraméterek
-ComputerName
Megadja a tartományhoz vagy munkacsoporthoz hozzáadni kívánt számítógépeket. Alapértelmezés szerint 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. Akkor is használhatja a ComputerName paramétert Add-Computer
, 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.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | Local computer |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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. Alapértelmezés szerint 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 az 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.
Típus: | PSCredential |
Aliasok: | DomainCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Aliasok: | DN, Domain |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Force
Letiltja a felhasználói megerősítési kérést. E paraméter Add-Computer
nélkül 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-LocalCredential
Olyan felhasználói fiókot ad meg, amely jogosult csatlakozni a ComputerName paraméter által megadott számítógépekhez. Alapértelmezés szerint 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 az UnjoinDomainCredential paramétert.
Ezt a paramétert a Windows PowerShell 3.0-ban vezettük be.
Típus: | PSCredential |
Position: | Named |
Alapértelmezett érték: | Current user |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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: Létrehoz egy tartományi fiókot. 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 egy 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: Beállítja a gép jelszavát a Credential(DomainCredential) paraméter értékére 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 . A NewName paraméter használatakor ez a beállítás automatikusan be van állítva. Ez a beállítás a Rename-Computer parancsmaggal használható. 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 csatlakoztathatja a számítógépet egy tartományhoz az új nevével.JoinReadOnly: Egy meglévő számítógépfiók használatával csatlakoztatja a számítógépet egy írásvédett tartományvezérlőhöz. 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.
Típus: | JoinOptions |
Elfogadott értékek: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Aliasok: | OU |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-PassThru
Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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 DomainName\ComputerName formátumban. Alapértelmezés szerint nincs megadva tartományvezérlő.
Típus: | String |
Aliasok: | DC |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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. Alapértelmezés szerint 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 meg szeretne adni egy olyan felhasználói fiókot, amely rendelkezik engedéllyel az új tartományhoz való csatlakozáshoz, 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.
Típus: | PSCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Unsecure
Nem biztonságos illesztés végrehajtása a megadott tartományhoz.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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".
Típus: | String |
Aliasok: | WGN |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
A parancsmagba a számítógépneveket és az Add-Computer
új neveket is beszövheti.
Kimenetek
A PassThru paraméter Add-Computer
használatakor egy ComputerChangeInfo objektumot ad vissza.
Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
- A Windows PowerShell 2.0-ban a kiszolgáló kiszolgálóparamétere
Add-Computer
akkor is meghiúsul, ha a kiszolgáló jelen van. A Windows PowerShell 3.0-ban a Kiszolgáló paraméter implementációja módosul, hogy megbízhatóan működjön.