Set-NetIPHttpsConfiguration

Set-NetIPHttpsConfiguration

Modifies an IP-HTTPS configuration.

構文

Parameter Set: ByPolicyStore
Set-NetIPHttpsConfiguration [-AsJob] [-AuthMode <AuthMode> ] [-CimSession <CimSession[]> ] [-PassThru] [-PolicyStore <String> ] [-Profile <String[]> ] [-ProfileActivated <Boolean[]> ] [-ServerURL <String> ] [-State <State> ] [-StrongCRLRequired <Boolean> ] [-ThrottleLimit <Int32> ] [-Type <Type> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByGpoSession
Set-NetIPHttpsConfiguration [-AsJob] [-AuthMode <AuthMode> ] [-CimSession <CimSession[]> ] [-GPOSession <String> ] [-PassThru] [-Profile <String[]> ] [-ProfileActivated <Boolean[]> ] [-ServerURL <String> ] [-State <State> ] [-StrongCRLRequired <Boolean> ] [-ThrottleLimit <Int32> ] [-Type <Type> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Set-NetIPHttpsConfiguration -InputObject <CimInstance[]> [-AsJob] [-AuthMode <AuthMode> ] [-CimSession <CimSession[]> ] [-PassThru] [-ServerURL <String> ] [-State <State> ] [-StrongCRLRequired <Boolean> ] [-ThrottleLimit <Int32> ] [-Type <Type> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




詳細説明

The Set-NetIPHttpsConfiguration cmdlet modifies an IP-HTTPS configuration.

You can specify the IP-HTTPS configuration profile to modify either by using a configuration object retrieved by the Get-NetIPHttpsConfiguration cmdlet or by specifying the profile name.

パラメーター

-AsJob

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-AuthMode<AuthMode>

Specifies the authentication mode.
このパラメーターに対して使用できる値:
-- 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 to which to store the configuration information.
You can use this parameter with the NetGPO cmdlets to aggregate multiple operations performed on a Group Policy Object (GPO).
You cannot use this parameter with the PolicyStore parameter.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-InputObject<CimInstance[]>

Specifies the object which contains the IP-HTTPS configuration to modify.


エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByValue)

ワイルドカード文字を許可する

false

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-PolicyStore<String>

Specifies the policy store that contains the IP-HTTPS configuration profile to set.
このパラメーターに対して使用できる値:
-- ActiveStore
-- PersistentStore
-- GPO
To set the configuration profile of a GPO, specify the GPO name using the following format: Domain\GPOName
You cannot use this parameter with the GPOSession parameter.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Profile<String[]>

Specifies the name of the profile to modify. This parameter is only allowed when the store is a GPO.


エイリアス

IPHttpsProfile

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-ProfileActivated<Boolean[]>

Filters the objects to modify.


エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-ServerURL<String>

Specifies the URL for the server. If the profile is a client profile, Windows attempts to connect to the server URL. If the profile is a server profile, then this is the URL to which the server listens.


エイリアス

なし

必須?

false

位置は?

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

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-StrongCRLRequired<Boolean>

Determines if a strong certificate revocation list (CRL) check is required before connection.
The default value 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. The parameter value set to 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 (http://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

  • None

    This cmdlet accepts no input objects.


出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

  • Microsoft.Management.Infrastructure.CimInstance#root\StandardCimv2\MSFT_NetIpHTTPsConfiguration

    Microsoft.Management.Infrastructure.CimInstance オブジェクトは、Windows Management Instrumentation (WMI) オブジェクトを表示するラッパー クラスです。シャープ記号 (#) の後のパスは、基になる WMI オブジェクトの名前空間とクラス名です。
    When the Passthru parameter is specified, this cmdlet outputs a modified IP-HTTPS configuration object.


Example 1: Set the server URL of the profile

This command modifies the profile named Redmond in the GPO named TestGPO, modifying the server URL.


PS C:\> Set-NetIPHttpsConfiguration -Profile Redmond -ServerURL https://da.com:443/IPHTTPs -PolicyStore Domain\TestGPO

Example 2: Set the server URL using IP-HTTPS configuration object

This command gets the IP-HTTPS configuration profile named Redmond in the GPO named TestGPO using the Get-NetIPHttpsConfiguration cmdlet, and then provides the output object as input to this cmdlet using the pipeline operator.


PS C:\> Get-NetIPHttpsConfiguration -Profile Redmond -PolicyStore Domain\TestGPO | Set-NetIPHttpsConfiguration -ServerURL https://da.com:443/IPHTTPs

関連トピック

コミュニティの追加

追加
表示: