New-GPStarterGPO
New-GPStarterGPO
Creates a new Starter GPO.
構文
Parameter Set: Default
New-GPStarterGPO [-Name] <String> [-Comment <String> ] [-Domain <String> ] [-Server <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
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.
パラメーター
-Comment<String>
Includes a comment for the new Starter GPO. The comment string must be enclosed in double-quoatation marks or single-quotation marks and can contain 2,047 characters.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Domain<String>
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.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Name<String>
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.
エイリアス |
なし |
必須? |
true |
位置は? |
1 |
既定値 |
NewGPO |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Server<String>
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.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Confirm
コマンドレットを実行する前に、ユーザーに確認を求めます。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-WhatIf
コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。
必須? |
false |
位置は? |
named |
既定値 |
false |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
None
This cmdlet does not accept any input.
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
Microsoft.GroupPolicy.StarterGpo
New-StarterGPO returns the Starter GPO that was created.
例
-------------------------- EXAMPLE 1 --------------------------
Description
-----------
This command creates a Starter GPO with the display name StarterSecurity. The Starter GPO is annotated with the specified comment.
PS C:\> New-GPStarterGPO -Name StarterSecurity -Comment "Security Template"