Unlock-ControlledGpo

Letzte Aktualisierung: August 2015

Betrifft: Advanced Group Policy Management 4.0 SP3

Unlock-ControlledGpo

Unlocks controlled GPOs.

Syntax

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




Detaillierte Beschreibung

The Unlock-ControlledGpo cmdlet unlocks controlled Group Policy Objects (GPOs) in an Advanced Group Policy Management (AGPM) archive. You can edit an unlocked GPO. Unlocking a GPO is the equivalent of checking out a 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 unlock. 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

-PassThru

Indicates that this cmdlet returns the controlled GPOs on which the cmdlet operates. If you do not specify this parameter, this cmdlet returns no results.


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.

  • Microsoft.Agpm.ControlledGpo

    This cmdlet returns controlled GPO objects, if you specify the PassThru parameter.


Beispiele

Example 1: Unlock all locked GPOs

This command uses the Get-ControlledGpo cmdlet to get all controlled GPOs in the current domain. The command passes those GPOs to the Where-Object cmdlet. That cmdlet passes any GPOs that have a state of CHECKED_IN to the current cmdlet. This cmdlet unlocks all of those GPOs. The cmdlet includes an explanatory comment.


PS C:\> Get-ControlledGpo | Where {$_.VaultState -eq "CHECKED_IN"} | Unlock-ControlledGpo -Comment "Unlock all GPOs"

Verwandte Themen

Community-Beiträge

HINZUFÜGEN
Anzeigen: