New-NetIPHttpsConfiguration
New-NetIPHttpsConfiguration
Creates an IP-HTTPS configuration.
構文
Parameter Set: ByPolicyStore
New-NetIPHttpsConfiguration [-PolicyStore] <String> -ServerURL <String> [-AsJob] [-AuthMode <AuthMode> ] [-CimSession <CimSession[]> ] [-Profile <String> ] [-State <State> ] [-StrongCRLRequired <Boolean> ] [-ThrottleLimit <Int32> ] [-Type <Type> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: ByGpoSession
New-NetIPHttpsConfiguration [-GPOSession] <String> -ServerURL <String> [-AsJob] [-AuthMode <AuthMode> ] [-CimSession <CimSession[]> ] [-Profile <String> ] [-State <State> ] [-StrongCRLRequired <Boolean> ] [-ThrottleLimit <Int32> ] [-Type <Type> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
詳細説明
The New-NetIPHttpsConfiguration cmdlet creates an IP-HTTPS configuration.
This cmdlet can create IP-HTTPS configurations on the ActiveStore, PersistentStore, or Group Policy Objects (GPOs).
パラメーター
-AsJob
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-AuthMode<AuthMode>
Specifies the authentication mode of the IP-HTTPS configuration.
このパラメーターに対して使用できる値:
-- None: Performs no client authentication during the SSL handshake. This is the default value.
-- Certificates: Uses client certificates to authenticate clients. This authentication mode applies only to a server interface on a computer running Windows Server® 2012.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-CimSession<CimSession[]>
リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。
エイリアス |
Session |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-GPOSession<String>
Specifies the Group Policy session in which to store the configuration information.
You can use this parameter with the NetGPO cmdlets to aggregate multiple operations performed on a GPO.
You cannot use this parameter with the PolicyStore parameter.
エイリアス |
なし |
必須? |
true |
位置は? |
2 |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-PolicyStore<String>
Specifies the policy store to which to add the configuration profile.
このパラメーターに対して使用できる値:
-- ActiveStore
-- PersistentStore
-- GPO
To add the configuration profile to a GPO, specify the GPO name using the following format: Domain\GPOName
You cannot use this parameter with the GPOSession parameter.
エイリアス |
なし |
必須? |
true |
位置は? |
2 |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Profile<String>
Specifies the name by which to identify the IP-HTTPS configuration profile. This option is only available if the store is a GPO.
エイリアス |
IPHttpsProfile |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-ServerURL<String>
Specifies the URL for the server. If the profile is a client profile, Windows Server 2012 attempts to connect to the server URL. If the profile is a server profile, then this is the URL on which the server listens.
Specify the server URL using the following format: https://myserver/IPHTTPS
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-State<State>
Specifies the state behavior of IP-HTTPS.
このパラメーターに対して使用できる値:
-- Default:
---- For a server interface, IP-HTTPS is always configured.
---- For a client interface, IP-HTTPS is configured on-demand based on the other connectivity options available. Client interfaces are created with this setting by default.
-- Enabled: IP-HTTPS is always configured, for both server interfaces and client interfaces. Server interfaces are created with this setting by default.
-- Disabled: Disables the IP-HTTPS interface.
-- OutsideEnabled: IP-HTTPs is configured on-demand whenever the computer is outside of the corporate network.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
Default |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-StrongCRLRequired<Boolean>
Indicates if a strong certificate revocation list (CRL) check is required before a connection.
By default, the value of this parameter is False.
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-ThrottleLimit<Int32>
このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0
を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。
エイリアス |
なし |
必須? |
false |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
false |
ワイルドカード文字を許可する |
false |
-Type<Type>
Specifies if IP-HTTPS should start in server mode or client mode. Server mode is only allowed on Windows Server 2012.
エイリアス |
なし |
必須? |
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 accepts no input objects.
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
System.Object
This cmdlet returns an object.
例
Example 1: Create an IP-HTTPS configuration
This command creates an IP-HTTPS configuration named Redmond with the specified server URL https://contoso.com:443/IPHTTPs in the GPO named TestGPO.
PS C:\> New-NetIPHttpsConfiguration -Profile "Redmond" -ServerURL "https://contoso.com:443/IPHTTPs" -PolicyStore "Domain\TestGPO"
関連トピック
Remove-NetIPHttpsConfiguration