Add-Computer
Adja hozzá a helyi számítógépet egy tartományhoz vagy munkacsoporthoz.
Syntax
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>]
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 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
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é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
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 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
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 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
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -Restart
Ez a parancs hozzáadja a Servers.txt fájlban 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.
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ámogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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ámogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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: | Current User Account Credentials |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | DomainCredential |
Paraméterkészletek
Workgroup
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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ámogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | DN, Szakterület |
Paraméterkészletek
Domain
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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ámogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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ámogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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ámogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Options
Speciális beállításokat ad meg a Számítógép hozzáadása illesztési művelethez. 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 Számítógép hozzáadása parancsmag automatikusan létrehoz egy tartományi fiókot, amikor hozzáad egy számítógépet 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.
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 meg van adva a Nem biztonságoscsatlakozás beállítás.
-- 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 parancsmagot használja a számítógép átnevezéséhez, de a módosítás hatékonyságának érdekében nem indítja újra a számítógépet, ezzel a paraméterrel csatlakozhat a számítógéphez egy tartományhoz az új nevével.
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 aJoinDomainOrWorkgroup metódus FJoinOptions paraméterének létrehozási (0x2) és törlési (0x4) jelzőit. A JoinDomainOrWorkgroup metódusról az MSDN-kódtárban található Win32_ComputerSystem osztályJoinDomainOrWorkgroup metódusában talál további információt. Ezekről a lehetőségekről további információt NetJoinDomain függvény az MSDN-kódtárban 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ámogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Domain
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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: | The default OU for machine objects for in the domain |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | OU |
Paraméterkészletek
Domain
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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ámogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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ő.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | DC |
Paraméterkészletek
Domain
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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ámogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Domain
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Unsecure
Nem biztonságos illesztés végrehajtása a megadott tartományhoz.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
Domain
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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ámogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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ámogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | WGN |
Paraméterkészletek
Workgroup
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Bevitelek
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.
Jegyzetek
- A Windows PowerShell 2.0-ban a server
Add-Computerparamé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.