Remove-Computer
Eltávolítja a helyi számítógépet a tartományából.
Syntax
Local (Alapértelmezett)
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remote
Remove-Computer
-UnjoinDomainCredential <PSCredential>
[-LocalCredential <PSCredential>]
[-Restart]
[-ComputerName <String[]>]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Remove-Computer parancsmag eltávolítja a helyi számítógépet és a távoli számítógépeket az aktuális tartományból.
Amikor eltávolít egy számítógépet egy tartományból, Remove-Computer a számítógép tartományi fiókját is letiltja. Explicit hitelesítő adatokat kell megadnia a számítógép tartományból való leválasztásához, még akkor is, ha azok az aktuális felhasználó hitelesítő adatai. A módosítás hatékonyságának eléréséhez újra kell indítania a számítógépet. Emellett, ha eltávolít egy számítógépet egy tartományból, át kell helyeznie egy munkacsoportba. A munkacsoport megadásához használja a WorkgroupName paramétert.
Ha egy számítógépet munkacsoportból tartományba szeretne áthelyezni, egyik munkacsoportból a másikba, vagy egyik tartományból a másikba, használja a Add-Computer parancsmagot.
A parancs eredményeinek lekéréséhez használja a Részletes és PassThru paramétereket. A felhasználói kérés letiltásához használja a Force paramétert.
Remove-Computer eltávolítja a helyi számítógépet és a távoli számítógépeket a tartományokból. Olyan hitelesítő paramétereket tartalmaz, amelyek alternatív hitelesítő adatokat adnak meg a távoli számítógépekhez való csatlakozáshoz, illetve a tartományból való csatlakozás megszüntetéséhez, egy Újraindítás paramétert az érintett számítógépek újraindításához, valamint egy WorkgroupName paramétert annak a munkacsoportnak a nevének megadásához, amelyhez a számítógépeket hozzáadják.
Példák
1. példa: A helyi számítógép eltávolítása a tartományból
Ez a példa eltávolítja a helyi számítógépet abból a tartományból, amelyhez csatlakozik.
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart
A UnjoinDomainCredential paraméter egy tartományi rendszergazda hitelesítő adatait biztosítja. A PassThru és a Részletes gyakori paraméterek a parancs sikerességével vagy sikertelenségével kapcsolatos információkat jelenítik meg. Az Újraindítás paraméter újraindítja a számítógépet az eltávolítási művelet befejezéséhez.
Ha nincs megadva munkacsoportnév, a rendszer áthelyezi a számítógépet a tartományból való eltávolítás után elnevezett munkacsoportba.
2. példa: Több számítógép áthelyezése örökölt munkacsoportba
Ez a példa eltávolítja a OldServers.txt fájlban felsorolt összes számítógépet a tartományaiból, és áthelyezi őket az Örökölt munkacsoportba.
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart
A LocalCredential paraméter egy olyan felhasználó hitelesítő adatait adja meg, aki engedéllyel rendelkezik a távoli számítógépekhez való csatlakozáshoz. A UnjoinDomainCredential paraméter egy olyan felhasználó hitelesítő adatait adja meg, aki engedéllyel rendelkezik a számítógépek tartományaikból való eltávolításához. A Force paraméter letiltja az egyes számítógépek megerősítési kéréseit. A Újraindítás paraméter újraindítja az egyes számítógépeket, miután eltávolították a tartományból.
3. példa: Számítógépek eltávolítása munkacsoportból megerősítés nélkül
Ez a példa eltávolítja a távoli számítógépet, a Server01-et és a helyi számítógépet a tartományaikból, és hozzáadja őket a Helyi munkacsoporthoz.
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
A Force paraméter letiltja az egyes számítógépek megerősítési kérését. A Újraindítás paraméter újraindítja a számítógépeket a módosítás hatékonyságának érdekében.
Paraméterek
-ComputerName
Megadja, hogy mely számítógépek legyenek eltávolítva a tartományukból. Az alapértelmezett beállítás a helyi számítógép.
Írja be a távoli számítógépek NetBIOS-nevét, IP-címét vagy teljes tartománynevét (FQDN). A helyi számítógép megadásához írja be a számítógép nevét, a pont (.) vagy a localhost nevet.
Ez a paraméter nem támaszkodik a PowerShell távoli elérésre. A Remove-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 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
Remote
| 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 |
-Force
Letiltja a felhasználói kérést. Alapértelmezés szerint Remove-Computer minden számítógép eltávolítása előtt megerősítést kér.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| 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: | False |
| Fennmaradó argumentumokból származó érték: | False |
-LocalCredential
Olyan felhasználói fiókot ad meg, amely engedéllyel rendelkezik a ComputerName paraméter által megadott számítógépekhez való csatlakozáshoz. Az alapértelmezett az aktuális felhasználó.
Írjon be egy felhasználónevet (például User01 or Domain01\User01), vagy írjon be egy PSCredential objektumot, például a Get-Credential parancsmag által generált objektumot. Ha felhasználónevet ír be, a parancsmag kéri a jelszót. 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.
Ezt a paramétert a 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
Remote
| 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
A parancs eredményeit adja vissza. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| 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: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Restart
Azt jelzi, hogy ez a parancsmag újraindítja az eltávolított 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 PowerShell 3.0-ban vezettük be.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| 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: | 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. A paraméter által megadott explicit hitelesítő adatok szükségesek a távoli számítógépek tartományból való eltávolításához, még akkor is, ha az érték az aktuális felhasználó hitelesítő adatai.
Í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 Ha felhasználónevet ír be, ez a parancsmag jelszó megadását kéri.
Ha olyan felhasználói fiókot szeretne megadni, amely jogosult csatlakozni a távoli számítógépekhez, használja a LocalCredential paramétert.
Ezt a paramétert a 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 |
| Aliasok: | Megbízólevél |
Paraméterkészletek
Local
| Position: | 0 |
| 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 |
Remote
| 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 |
-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épek hozzáadódnak, amikor eltávolítják őket a tartományukból. Az alapértelmezett érték MUNKACSOPORT. Amikor eltávolít egy számítógépet egy tartományból, azt hozzá kell adnia egy munkacsoporthoz.
Ezt a paramétert a 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: | 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
Ehhez a parancsmaghoz számítógépneveket is átirányíthat.
Kimenetek
ComputerChangeInfo
Ha a PassThru paramétert használja, Remove-Computer egy ComputerChangeInfo objektumot ad vissza.
Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
Ez a parancsmag nem távolítja el a számítógépeket a munkacsoportokból.