GroupPolicyObject.CreateNew Method (Domain, String, Boolean, Boolean)

Creates a new Group Policy object (GPO) with the specified display name in the specified domain.

Namespace: Microsoft.GroupPolicy
Assembly: Microsoft.GroupPolicy.Management.Interop (in Microsoft.GroupPolicy.Management.Interop.dll)

Syntax

public void CreateNew(
    Domain domain,
    string gpoDisplayName,
    bool readOnly,
    bool loadRegistry
)

public:
void CreateNew(
    Domain^ domain,
    String^ gpoDisplayName,
    bool readOnly,
    bool loadRegistry
)

member CreateNew : 
        domain:Domain *
        gpoDisplayName:string *
        readOnly:bool *
        loadRegistry:bool -> unit

Public Sub CreateNew (
    domain As Domain,
    gpoDisplayName As String,
    readOnly As Boolean,
    loadRegistry As Boolean
)

domain
Type: System.DirectoryServices.ActiveDirectory.Domain

Represents the domain in which to create the new GPO.

readOnly
Type: System.Boolean

true to open the GPO in read-only mode; otherwise, false.

loadRegistry
Type: System.Boolean

true to load the registry; otherwise, false.

Exception	Condition
ArgumentException	gpoDisplayName is an empty string (“”).
ArgumentNullException	The domain parameter or the gpoDisplayName parameter is null.
ObjectDisposedException	The GroupPolicyObject is disposed.

The new GPO is opened according to the value of the readOnly and loadRegistry parameters.

To open an existing GPO, you can use one of the overloaded OpenDSGpo methods.