Add-ControlledGpo

Mis à jour: août 2015

S'applique à: Advanced Group Policy Management 4.0 SP3

Add-ControlledGpo

Adds GPOs to an AGPM archive.

Syntaxe

Parameter Set: Default
Add-ControlledGpo [[-Gpos] <Gpo[]> ] [-Comment <String> ] [-PassThru] [ <CommonParameters>]




Description détaillée

The Add-ControlledGpo cmdlet adds uncontrolled Group Policy Objects (GPOs) to an Advanced Group Policy Management (AGPM) archive. That GPO becomes a controlled GPO.

Paramètres

-Comment<String>

Specifies a comment for the change that this cmdlet makes.


Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Gpos<Gpo[]>

Specifies an array of GPOs to add to the AGPM archive. To obtain GPOs, use the Get-Gpo cmdlet. For more information, type Get-Help Get-Gpo.


Alias

none

Obligatoire ?

false

Position ?

1

Valeur par défaut

none

Accepter l’entrée de pipeline ?

true(ByValue,ByPropertyName)

Accepter les caractères génériques ?

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.


Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.

  • Microsoft.GroupPolicy.Gpo

    This cmdlet accepts GPO objects.


Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

  • Microsoft.Agpm.ControlledGpo

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


Exemples

Example 1: Add a GPO by using the pipeline operator

This command uses the Get-Gpo cmdlet to get the uncontrolled GPO named TSQA Group policies. For more information, type Get-Help Get-Gpo. The command passes that GPO to the current cmdlet. This cmdlet adds that GPO to the AGPM archive.


PS C:\> Get-Gpo -Name "TSQA Group policies" | Add-ControlledGpo -PassThru

Example 2: Add a GPO by using a variable

The first command uses Get-Gpo to get the uncontrolled GPO named TSQA Group policies, and then stores that object in the $GpoObject variable.

The second command adds the object stored in $GpoObject to the AGPM archive.


PS C:\> $GpoObject = Get-Gpo -Name "TSQA Group policies"
PS C:\> Add-ControlledGpo -Gpos $GpoObject -PassThru

Rubriques connexes

Ajouts de la communauté

AJOUTER
Afficher: