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"

関連トピック

Get-NetIPHttpsConfiguration

Remove-NetIPHttpsConfiguration

Rename-NetIPHttpsConfiguration

Reset-NetIPHttpsConfiguration

Set-NetIPHttpsConfiguration