Rename-NetIPHttpsConfiguration

Rename-NetIPHttpsConfiguration

Renames an IP-HTTPS profile.

構文

Parameter Set: ByPolicyStore
Rename-NetIPHttpsConfiguration -NewName <String> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-PolicyStore <String> ] [-Profile <String[]> ] [-ProfileActivated <Boolean[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: ByGpoSession
Rename-NetIPHttpsConfiguration -NewName <String> [-AsJob] [-CimSession <CimSession[]> ] [-GPOSession <String> ] [-PassThru] [-Profile <String[]> ] [-ProfileActivated <Boolean[]> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Rename-NetIPHttpsConfiguration -InputObject <CimInstance[]> -NewName <String> [-AsJob] [-CimSession <CimSession[]> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Rename-NetIPHttpsConfiguration cmdlet renames an IP-HTTPS profile, either on a computer or in a Group Policy Object (GPO).

パラメーター

-AsJob

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。

-GPOSession<String>

Specifies the Group Policy session which contains the IP-HTTPS configuration to rename.
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.

-InputObject<CimInstance[]>

Specifies the object which contains an IP-HTTPS profile to rename.

-NewName<String>

Specifies the new name for the IP-HTTPS profile.

-PassThru

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

-PolicyStore<String>

Specifies the policy store that contains the configuration profile to rename.
このパラメーターに対して使用できる値:
-- GPO
To rename 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.

-Profile<String[]>

Specifies the name of the profile to rename.

-ProfileActivated<Boolean[]>

Specifies which profile to rename.

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://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 Windows Management Instrumentation (WMI) object.

例

Example 1: Rename an IP-HTTPS profile using a configuration object

This set of commands uses the Get-NetIPHttpsConfiguration cmdlet to get an IP-HTTPS configuration object and stores it in a variable named $config. The contents of the variable are then passed to this cmdlet.

PS C:\> $config = Get-NetIPHttpsConfiguration –PolicyStore "testdomain\GPOName"

PS C:\> Rename-NetIPHttpsConfiguration –InputObject $config

Example 2: Rename an IP-HTTPS profile

This command renames the IP-HTTPS profile named Redmond to Fareast.

PS C:\> Rename-NetIPHttpsConfiguration –Profile Redmond –NewName Fareast

関連トピック

Get-NetIPHttpsConfiguration

New-NetIPHttpsConfiguration

Remove-NetIPHttpsConfiguration

Reset-NetIPHttpsConfiguration

Set-NetIPHttpsConfiguration