Approve-PSGPO¶
Approves GPOs that wait for their approval (approval workflow).
L'aide de la commande, telle que Get-Help Approve-PSGPO -Full la donne (en anglais).
Syntaxe¶
Approve-PSGPO [-Name] <string[]> [[-CreatorRights] <string>] [[-ApplyTo] <string>] [[-DenyTo] <string>] [[-GroupContainer] <string>] [[-BackupPath] <string>] [[-Directory] <GPOToolsDirectory>] [[-Server] <string>] [-CreateFilteringGroups] [-WhatIf] [-Confirm] [<CommonParameters>]
Description¶
A GPO a creator (Tier 1) creates waits for its approval: its creator owns it, and it applies to nobody. An approver (Tier 0) approves it:
- its owner becomes the owner of the approved GPOs (Workflow.ApprovedOwner), in the directory and in SYSVOL, its folder and every file in it: the creator cannot give itself its rights back;
- the creator and the groups of creators lose their rights; the groups of creators of the creator keep editing its settings (-CreatorRights EditSettings: each change makes it differ from its approved version, Get-PSGPODrift) or only read it (ReadOnly);
- it applies to -ApplyTo and is denied to -DenyTo; with -CreateFilteringGroups, to its new
groups APPLY_
and DENY_ (the prefixes, scope and container of the configuration: NewGpo.SecurityFilteringGroups), created first by the approver: a GPO whose groups cannot be created is not approved. Without them, the GPO applies to its groups APPLY_ and DENY_ when they exist, else to Authenticated Users; - it is backed up with the approved label (Backup.ApprovedLabel), in -BackupPath.
Whoever manages the members of the group that applies the GPO decides where it applies: the groups the approver creates are its own.
The settings of the GPO that HGPM does not interpret (a client-side extension whose settings it does not read, a file of its folder no reader of HGPM reads) are said in a warning and in the confirmation: the computers apply them all the same. Review them with GPMC, or in the files of the GPO, before confirming (Get-PSGPOReport lists them).
Paramètres¶
-Name¶
Display names of the GPOs (wildcards allowed).
| Type | Obligatoire | Position | Valeur par défaut | Accepte le pipeline |
|---|---|---|---|---|
String[] |
Oui | 1 | Aucune | Oui |
-CreatorRights¶
What the creators may still do with the GPO: ReadOnly or EditSettings; by default the one of the configuration (Workflow.CreatorRights).
| Type | Obligatoire | Position | Valeur par défaut | Accepte le pipeline |
|---|---|---|---|---|
String |
Non | 2 | Aucune | Non |
-ApplyTo¶
The group of the domain that applies the GPO; by default its group APPLY_
| Type | Obligatoire | Position | Valeur par défaut | Accepte le pipeline |
|---|---|---|---|---|
String |
Non | 3 | Aucune | Non |
-DenyTo¶
A group of the domain the GPO is denied to; by default its group DENY_
| Type | Obligatoire | Position | Valeur par défaut | Accepte le pipeline |
|---|---|---|---|---|
String |
Non | 4 | Aucune | Non |
-CreateFilteringGroups¶
Creates the groups APPLY_
| Type | Obligatoire | Position | Valeur par défaut | Accepte le pipeline |
|---|---|---|---|---|
SwitchParameter |
Non | Nommé | Aucune | Non |
-GroupContainer¶
Where -CreateFilteringGroups creates the groups; by default the container of the configuration (NewGpo.SecurityFilteringGroups.Container), else the users container.
| Type | Obligatoire | Position | Valeur par défaut | Accepte le pipeline |
|---|---|---|---|---|
String |
Non | 5 | Aucune | Non |
-BackupPath¶
Root folder of the backups; by default the one of the History tab of the window.
| Type | Obligatoire | Position | Valeur par défaut | Accepte le pipeline |
|---|---|---|---|---|
String |
Non | 6 | Aucune | Non |
-Directory¶
Directory of the domain (Get-PSGPODirectory); the domain is read when not given.
| Type | Obligatoire | Position | Valeur par défaut | Accepte le pipeline |
|---|---|---|---|---|
GPOToolsDirectory |
Non | 7 | Aucune | Non |
-Server¶
Domain controller to read the domain from, without -Directory.
| Type | Obligatoire | Position | Valeur par défaut | Accepte le pipeline |
|---|---|---|---|---|
String |
Non | 8 | Aucune | Non |
-WhatIf¶
| Type | Obligatoire | Position | Valeur par défaut | Accepte le pipeline |
|---|---|---|---|---|
SwitchParameter |
Non | Nommé | Aucune | Non |
-Confirm¶
| Type | Obligatoire | Position | Valeur par défaut | Accepte le pipeline |
|---|---|---|---|---|
SwitchParameter |
Non | Nommé | Aucune | Non |
Exemples¶
Exemple 1¶
Exemple 2¶
Approve-PSGPO -Name 'T1 - Servers - Proxy' -CreateFilteringGroups -GroupContainer 'OU=Groups,OU=Tier 1'
Exemple 3¶
Sorties¶
System.Management.Automation.PSObject