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.

Type:String[]
Position:Named
Default value:Local computer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSCredential
Aliases:DomainCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:DN, Domain
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

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.

Type:String
Aliases:OU
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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ő.

Type:String
Aliases:DC
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Unsecure

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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".

Type:String
Aliases:WGN
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

String

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

Kimenetek

ComputerChangeInfo

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