Edit

New-GPStarterGPO

  • Reference
Module:
GroupPolicy

Creates a new Starter GPO.

Syntax

New-GPStarterGPO
   [-Name] <String>
   [-Comment <String>]
   [-Domain <String>]
   [-Server <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-GPStarterGPO cmdlet creates a Starter GPO with the specified name. If the Starter GPOs folder does not exist in the SYSVOL when the New-GPStarterGPO cmdlet is called, it is created and populated with the eight Starter GPOs that ship with Group Policy.

Examples

-------------------------- EXAMPLE 1 --------------------------

PS C:\> New-GPStarterGPO -Name StarterSecurity -Comment "Security Template"

Description

This command creates a Starter GPO with the display name StarterSecurity. The Starter GPO is annotated with the specified comment.

Parameters

-Comment

Includes a comment for the new Starter GPO. The comment string must be enclosed in double-quotation marks or single-quotation marks and can contain 2,047 characters.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Domain

Specifies the domain for this cmdlet. You must specify the fully qualified domain name (FQDN) of the domain (for example: sales.contoso.com).

Note: Cross-domain creation of Starter GPOs is not supported. If you specify a domain that is different from the domain of the user that is running the current session, an error occurs.

If you do not specify the Domain parameter, the domain of the user that is running the current session is used.

You can also refer to the Domain parameter by its built-in alias, "domainname". For more information, see about_Aliases.

Type:String
Aliases:DomainName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the display name for the new Starter GPO.

If another Starter GPO with the same display name exists in the domain, an error occurs.

You can also refer to the Name parameter by its built-in alias, "displayname". For more information, see about_Aliases.

Type:String
Aliases:DisplayName
Position:0
Default value:NewGPO
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Server

Specifies the name of the domain controller that this cmdlet contacts to complete the operation. You can specify either the fully qualified domain name (FQDN) or the host name. For example:

FQDN: DomainController1.SalesDomain.Contoso.com

Host Name: DomainController1

If you do not specify the name by using the Server parameter, the PDC emulator will be contacted.

You can also refer to the Server parameter by its built-in alias, "dc". For more information, see about_Aliases.

Type:String
Aliases:DC
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

This cmdlet does not accept any input.

Outputs

Microsoft.GroupPolicy.StarterGpo

New-StarterGPO returns the Starter GPO that was created.