Remove-ControlledGpo

Letzte Aktualisierung: August 2015

Betrifft: Advanced Group Policy Management 4.0 SP3

Remove-ControlledGpo

Removes controlled GPOs from the AGPM archive.

Syntax

Parameter Set: Default
Remove-ControlledGpo [[-ControlledGpos] <ControlledGpo[]> ] [-Comment <String> ] [-Domain <String> ] [ <CommonParameters>]




Detaillierte Beschreibung

The Remove-ControlledGpo cmdlet removes controlled Group Policy Objects (GPOs) from the Advanced Group Policy Management (AGPM) archive. A removed GPO is no longer controlled. This cmdlet does not delete the GPO. To remove the GPO from the production environment, use the Remove-Gpo cmdlet. For more information, type Get-Help Remove-Gpo.

Parameter

-Comment<String>

Specifies a comment for the change that this cmdlet makes.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-ControlledGpos<ControlledGpo[]>

Specifies an array of GPOs to remove. To obtain controlled GPOs, use the Get-ControlledGpo cmdlet.


Aliasse

none

Erforderlich?

false

Position?

1

Standardwert

none

Pipelineeingaben akzeptieren?

true(ByValue,ByPropertyName)

Platzhalterzeichen akzeptieren?

false

-Domain<String>

Specifies the fully qualified domain name (FQDN) of a domain. This cmdlet operates on GPOs in the domain that this parameter specifies. If the AGPM service runs as part of a different domain, and if this cmdlet specifies that domain, a trust relationship must exist between that domain and the domain of the current user or computer.

If you do not specify a domain, this cmdlet uses the domain of the current user.

If you use this cmdlet as part of a computer startup or shutdown script, and if the command does not specify this parameter, the cmdlet uses the domain of the computer.


Aliasse

none

Erforderlich?

false

Position?

named

Standardwert

none

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

  • Microsoft.Agpm.ControlledGpo

    This cmdlet accepts controlled GPOs.


Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

Beispiele

Example 1: Remove a GPO

This command uses the Get-ControlledGpo cmdlet to get all controlled GPOs in the specified domain. The command passes those GPOs to the Where-Object cmdlet. That cmdlet passes any GPOs named test to the current cmdlet. This cmdlet removes that test GPO from the AGPM archive.


PS C:\> Get-ControlledGpo -Domain "TSQA.Contoso.com" | Where {$_.Name -eq "test"} | Remove-ControlledGpo

Verwandte Themen

Community-Beiträge

HINZUFÜGEN
Anzeigen: