Remove-Computer
Odebere místní počítač ze své domény.
Syntax
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
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 jejich aktuálních domén.
Když odeberete počítač z domény, Remove-Computer
zakáže také účet domény počítače. Pokud chcete zrušit připojení počítače k jeho doméně, musíte zadat explicitní přihlašovací údaje, a to i v případě, že se jedná o přihlašovací údaje aktuálního uživatele. Aby se změna projevila, musíte restartovat počítač. Pokud počítač odeberete z domény, musíte ho přesunout do pracovní skupiny. Pomocí parametru WorkgroupName určete pracovní skupinu.
Pokud chcete přesunout počítač z pracovní skupiny do domény, z jedné pracovní skupiny do druhé nebo z jedné domény do druhé, použijte rutinu Add-Computer
.
Pokud chcete získat výsledky příkazu, použijte parametry Verbose a PassThru . Pokud chcete potlačit výzvu uživatele, použijte parametr Force .
Remove-Computer
odebere místní počítač a vzdálené počítače z domén. Obsahuje 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 zrušení připojení k doméně, parametr Restart pro restartování ovlivněných počítačů a parametr WorkgroupName pro určení názvu pracovní skupiny, do které jsou počítače přidány.
Příklady
Příklad 1: Odebrání místního počítače z jeho 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. Společné parametry PassThru a Verbose 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í ze své 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 OldServers.txt
souboru z jejich domén a přesune je do starší 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 Restart restartuje každý počítač po jeho odebrání z jeho 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č ze svých domén a přidá je do místní pracovní skupiny.
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 ze svých domén. Výchozí hodnotou je místní počítač.
Zadejte název NetBIOS, IP adresu nebo plně kvalifikovaný název domény (FQDN) vzdálených počítačů. Pokud chcete zadat místní počítač, zadejte název počítače, tečku (.) nebo localhost.
Tento parametr nespoléhá na vzdálené komunikace PowerShellu. Parametr ComputerName můžete použít i v případě, že váš počítač není nakonfigurovaný pro spouštění vzdálených Remove-Computer
příkazů.
Tento parametr byl zaveden v PowerShellu 3.0.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Potlačí výzvu uživatele. Ve výchozím nastavení Remove-Computer
vás před odebráním jednotlivých počítačů vyzve k potvrzení.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LocalCredential
Určuje uživatelský účet, který má oprávnění pro připojení k počítačům, které určuje parametr ComputerName . Ve výchozím nastavení je to 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 ze své aktuální domény, použijte parametr UnjoinDomainCredential .
Tento parametr byl zaveden v PowerShellu 3.0.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Vrátí výsledky příkazu. V opačném případě tato rutina negeneruje žádný výstup.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Restart
Označuje, že tato rutina restartuje odebrané počítače. Aby se změna projevila, často se vyžaduje restartování.
Tento parametr byl zaveden v PowerShellu 3.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UnjoinDomainCredential
Určuje uživatelský účet, který má oprávnění k odebrání počítačů ze svých 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ích údajů aktuálního uživatele.
Zadejte uživatelské jméno, například User01 nebo Domain01\User01, nebo zadejte objekt PSCredential , například objekt vygenerovaný nástrojem 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 zaveden v PowerShellu 3.0.
Type: | PSCredential |
Aliases: | Credential |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkgroupName
Určuje název pracovní skupiny, do které jsou počítače přidány, když jsou odebrány ze svých 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 zaveden v PowerShellu 3.0.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
Názvy počítačů můžete do této rutiny převést.
Výstupy
Při použití parametru PassThru vrátí Remove-Computer
objekt ComputerChangeInfo .
V opačném případě tato rutina negeneruje žádný výstup.
Poznámky
Tato rutina neodebere počítače z pracovních skupin.