Remove-Computer
Tar bort den lokala datorn från domänen.
Syntax
Local (Standard)
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
Cmdleten Remove-Computer tar bort den lokala datorn och fjärrdatorerna från deras aktuella domäner.
När du tar bort en dator från en domän inaktiverar Remove-Computer även datorns domänkonto. Du måste ange explicita autentiseringsuppgifter för att koppla från datorn från dess domän, även om de är den aktuella användarens autentiseringsuppgifter. Du måste starta om datorn för att ändringen ska gälla. När du tar bort en dator från en domän måste du också flytta den till en arbetsgrupp. Använd parametern WorkgroupName för att ange arbetsgruppen.
Om du vill flytta en dator från en arbetsgrupp till en domän, från en arbetsgrupp till en annan eller från en domän till en annan använder du cmdleten Add-Computer.
Använd parametrarna Verbose och PassThru för att hämta resultatet av kommandot. Om du vill ignorera användarprompten använder du parametern Force.
Remove-Computer tar bort den lokala datorn och fjärrdatorerna från domäner. Den innehåller parametrar för autentiseringsuppgifter som anger alternativa autentiseringsuppgifter för anslutning till fjärrdatorer och avkoppling från en domän, parametern Starta om för att starta om de berörda datorerna och parametern WorkgroupName för att ange namnet på den arbetsgrupp som datorer läggs till i.
Exempel
Exempel 1: Ta bort den lokala datorn från domänen
Det här exemplet tar bort den lokala datorn från domänen som den är ansluten till.
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart
Parametern UnjoinDomainCredential innehåller autentiseringsuppgifterna för en domänadministratör. PassThru- och de utförliga gemensamma parametrarna visar information om kommandots framgång eller misslyckande. Parametern Restart startar om datorn för att slutföra borttagningsåtgärden.
När inget arbetsgruppsnamn har angetts flyttas datorn till arbetsgruppen med namnet efter att den har tagits bort från domänen.
Exempel 2: Flytta flera datorer till en äldre arbetsgrupp
Det här exemplet tar bort alla datorer som anges i OldServers.txt-filen från deras domäner och flyttar dem till Äldre arbetsgrupp.
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart
Parametern LocalCredential innehåller autentiseringsuppgifterna för en användare som har behörighet att ansluta till fjärrdatorer. Parametern UnjoinDomainCredential ger autentiseringsuppgifterna för en användare som har behörighet att ta bort datorerna från sina domäner. Parametern Force undertrycker bekräftelseprompterna för varje dator. Parametern Restart startar om var och en av datorerna när den har tagits bort från domänen.
Exempel 3: Ta bort datorer från en arbetsgrupp utan bekräftelse
Det här exemplet tar bort fjärrdatorn, Server01 och den lokala datorn från deras domäner och lägger till dem i arbetsgruppen Local.
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
Parametern Force undertrycker bekräftelseprompten för varje dator. Parametern Restart startar om datorerna för att göra ändringen effektiv.
Parametrar
-ComputerName
Anger vilka datorer som ska tas bort från deras domäner. Standardvärdet är den lokala datorn.
Ange NetBIOS-namnet, en IP-adress eller ett fullständigt domännamn (FQDN) för fjärrdatorerna. Om du vill ange den lokala datorn skriver du datornamnet, en punkt (.) eller localhost.
Den här parametern förlitar sig inte på PowerShell-fjärrkommunikation. Du kan använda parametern ComputerName för Remove-Computer även om datorn inte är konfigurerad för att köra fjärrkommandon.
Den här parametern introducerades i PowerShell 3.0.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Remote
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | jfr |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Force
Undertrycker användarprompten. Som standard uppmanar Remove-Computer dig att bekräfta innan du tar bort varje dator.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-LocalCredential
Anger ett användarkonto som har behörighet att ansluta till de datorer som parametern ComputerName anger. Standardvärdet är den aktuella användaren.
Ange ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential- objekt, till exempel ett som genereras av Get-Credential cmdlet. Om du skriver ett användarnamn uppmanas du att ange ett lösenord i cmdleten. Om du vill ange ett användarkonto som har behörighet att ta bort datorn från den aktuella domänen använder du parametern UnjoinDomainCredential.
Den här parametern introducerades i PowerShell 3.0.
Parameteregenskaper
| Typ: | PSCredential |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
Remote
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-PassThru
Returnerar resultatet av kommandot. Annars genererar den här cmdleten inga utdata.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Restart
Anger att den här cmdleten startar om de datorer som tas bort. En omstart krävs ofta för att göra ändringen effektiv.
Den här parametern introducerades i PowerShell 3.0.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-UnjoinDomainCredential
Anger ett användarkonto som har behörighet att ta bort datorerna från sina aktuella domäner. Explicita autentiseringsuppgifter, enligt den här parametern, krävs för att ta bort fjärrdatorer från en domän, även när värdet är den aktuella användarens autentiseringsuppgifter.
Skriv ett användarnamn, till exempel User01 eller Domain01\User01, eller ange ett PSCredential- objekt, till exempel ett som genereras av Get-Credential. Om du skriver ett användarnamn uppmanas du att ange ett lösenord i den här cmdleten.
Om du vill ange ett användarkonto som har behörighet att ansluta till fjärrdatorerna använder du parametern LocalCredential.
Den här parametern introducerades i PowerShell 3.0.
Parameteregenskaper
| Typ: | PSCredential |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Behörighet |
Parameteruppsättningar
Local
| Position: | 0 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
Remote
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Wi |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-WorkgroupName
Anger namnet på en arbetsgrupp som datorerna läggs till i när de tas bort från sina domäner. Standardvärdet är WORKGROUP. När du tar bort en dator från en domän måste du lägga till den i en arbetsgrupp.
Den här parametern introducerades i PowerShell 3.0.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
String
Du kan skicka datornamn till den här cmdleten.
Utdata
ComputerChangeInfo
När du använder parametern PassThru returnerar Remove-Computer ett ComputerChangeInfo--objekt.
Annars genererar den här cmdleten inga utdata.
Kommentarer
Den här cmdleten tar inte bort datorer från arbetsgrupper.
