Remove-Computer
Odebere místní počítač z jeho domény.
Syntax
Local (Výchozí)
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
Rutina Remove-Computer odebere místní počítač a vzdálené počítače z aktuálních domén.
Když odeberete počítač z domény, Remove-Computer také zakáže účet domény počítače. Musíte zadat explicitní přihlašovací údaje pro zrušení spojení počítače z jeho domény, i když se jedná o přihlašovací údaje aktuálního uživatele. Aby se změna projevila, je nutné restartovat počítač. Pokud odeberete počítač z domény, musíte ho přesunout do pracovní skupiny. K zadání pracovní skupiny použijte parametr WorkgroupName.
Pokud chcete přesunout počítač z pracovní skupiny do domény, z jedné pracovní skupiny do jiné nebo z jedné domény do jiné, použijte rutinu Add-Computer.
Pokud chcete získat výsledky příkazu, použijte parametry Podrobné a PassThru. Pokud chcete potlačit výzvu uživatele, použijte parametr Vynutit.
Remove-Computer odebere místní počítač a vzdálené počítače z domén. Zahrnuje parametry přihlašovacích údajů, které určují alternativní přihlašovací údaje pro připojení ke vzdáleným počítačům a odpojování z domény, parametr Restartování pro restartování ovlivněných počítačů a parametr WorkgroupName pro zadání názvu pracovní skupiny, do které se přidají počítače.
Příklady
Příklad 1: Odebrání místního počítače z domény
Tento příklad odebere místní počítač z domény, ke které je připojený.
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart
Parametr UnjoinDomainCredential poskytuje přihlašovací údaje správce domény. PassThru a Podrobné běžné parametry zobrazují informace o úspěchu nebo selhání příkazu. Parametr Restart restartuje počítač, aby se dokončila operace odebrání.
Pokud není zadán žádný název pracovní skupiny, počítač se přesune do pracovní skupiny pojmenované po odebrání z domény.
Příklad 2: Přesunutí několika počítačů do starší pracovní skupiny
Tento příklad odebere všechny počítače uvedené v souboru OldServers.txt ze svých domén a přesune je do starší verze pracovní skupiny.
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart
Parametr LocalCredential poskytuje přihlašovací údaje uživatele, který má oprávnění k připojení ke vzdáleným počítačům. Parametr UnjoinDomainCredential poskytuje přihlašovací údaje uživatele, který má oprávnění k odebrání počítačů ze svých domén. Parametr Force potlačí výzvy k potvrzení pro každý počítač. Parametr Restartovat restartuje každý počítač po odebrání z domény.
Příklad 3: Odebrání počítačů z pracovní skupiny bez potvrzení
Tento příklad odebere vzdálený počítač, Server01 a místní počítač z jejich domén a přidá je do Místní pracovní skupina.
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
Parametr Force potlačí výzvu k potvrzení pro každý počítač. Parametr Restart restartuje počítače, aby se změna projevila.
Parametry
-ComputerName
Určuje počítače, které mají být odebrány z jejich domén. Výchozí hodnota je místní počítač.
Zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény (FQDN) vzdálených počítačů. Chcete-li zadat místní počítač, zadejte název počítače, tečku (.) nebo localhost.
Tento parametr nespoléhá na vzdálenou správu PowerShellu. Parametr ComputerName můžete použít v rámci Remove-Computer, i když váš počítač není nakonfigurován pro spouštění vzdálených příkazů.
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Remote
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Potlačí výzvu uživatele. Ve výchozím nastavení vás Remove-Computer před odebráním jednotlivých počítačů vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-LocalCredential
Určuje uživatelský účet, který má oprávnění pro připojení k počítačům, které určuje parametr ComputerName. Výchozí hodnota je aktuální uživatel.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential , například objekt vygenerovaný rutinou Get-Credential . Pokud zadáte uživatelské jméno, rutina vás vyzve k zadání hesla. Chcete-li zadat uživatelský účet, který má oprávnění k odebrání počítače z jeho aktuální domény, použijte parametr UnjoinDomainCredential.
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
Remote
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-PassThru
Vrátí výsledky příkazu. Jinak tento příkaz negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Restart
Označuje, že tato rutina restartuje odebrané počítače. K efektivní změně se často vyžaduje restartování.
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-UnjoinDomainCredential
Určuje uživatelský účet, který má oprávnění k odebrání počítačů z aktuálních domén. Explicitní přihlašovací údaje, které poskytuje tento parametr, se vyžadují k odebrání vzdálených počítačů z domény, i když je hodnota přihlašovacími údaji aktuálního uživatele.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential , například objekt vygenerovaný programem Get-Credential. Pokud zadáte uživatelské jméno, tato rutina vás vyzve k zadání hesla.
Chcete-li zadat uživatelský účet, který má oprávnění pro připojení ke vzdáleným počítačům, použijte parametr LocalCredential.
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Pověření |
Sady parametrů
Local
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
Remote
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WorkgroupName
Určuje název pracovní skupiny, do které jsou počítače přidány při jejich odebrání z jejich domén. Výchozí hodnota je WORKGROUP. Když odeberete počítač z domény, musíte ho přidat do pracovní skupiny.
Tento parametr byl představen v PowerShellu 3.0.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
String
Do thiscmdlet můžete přesměrovat názvy počítačů.
Výstupy
ComputerChangeInfo
Pokud použijete parametr PassThru, Remove-Computer vrátí objekt ComputerChangeInfo.
Jinak tento příkaz negeneruje žádný výstup.
Poznámky
Tato rutina neodebere počítače z pracovních skupin.