Get-NetIPsecDospSetting

Get-NetIPsecDospSetting

Retrieves IPsec DoS protection settings from the target computer.

構文

Parameter Set: ByName
Get-NetIPsecDospSetting [-Name] <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: GetAll
Get-NetIPsecDospSetting [-All] [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

詳細説明

The Get-NetIPsecDospSetting cmdlet returns the instances of existing IPsec DoS protection settings.

If the Name parameter is not specified, then all of the Dosp settings configured on the computer are returned. Querying by object requires the use of the Where-Object cmdlet.

パラメーター

-All

Indicates that all of the Dosp settings within the specified policy store are retrieved.

-AsJob

-CimSession<CimSession[]>

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

-Name<String[]>

Specifies that only the matching IPsec rules of the indicated name are retrieved. Wildcard characters are accepted.
This parameter acts just like a file name, in that only one rule with a given name may exist in a policy store at a time. During group policy processing and policy merge, rules that have the same name but come from multiple stores being merged, will overwrite one another so that only one exists. This overwriting behavior is desirable if the rules serve the same purpose. For instance, all of the firewall rules have specific names, so if an administrator can copy these rules to a GPO, and the rules will override the local versions on a local computer. GPOs can have precedence. So if an administrator has a different or more specific rule with the same name in a higher-precedence GPO, then it overrides other rules that exist.
The default value is a randomly assigned value.
When the defaults for main mode encryption need to overridden, specify the customized parameters and set this parameter value, making this parameter the new default setting for encryption.

-ThrottleLimit<Int32>

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

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

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

• None

出力

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

• Microsoft.Management.Infrastructure.CimInstance#root\StandardCimv2\NetIPsecDospSetting[]

  Microsoft.Management.Infrastructure.CimInstance オブジェクトは、Windows Management Instrumentation (WMI) オブジェクトを表示するラッパー クラスです。シャープ記号 (#) の後のパスは、基になる WMI オブジェクトの名前空間とクラス名です。

例

EXAMPLE 1

This example gets all of the Dosp setting configured on the computer.

PS C:\> Get-NetIPsecDospSetting

EXAMPLE 2

This example gets the Dosp setting with the specified name.

PS C:\> Get-NetIPsecDospSetting -Name CorpNet-PubNet

EXAMPLE 3

This example gets all of the Dosp settings configured to the specified internal interface.

PS C:\> $netIPSDospSetting = Get-NetIPsecDospSetting

PS C:\> Where-Object –FilterScript { $_.PublicInterfaceAliases –Eq "PubNet" } –InputObject $netIPSDospSetting

This cmdlet can be run using only the pipeline.

PS C:\> Get-NetIPsecDospSetting | Where-Object –FilterScript { $_.PublicInterfaceAliases –Eq "PubNet" }

EXAMPLE 4

This example modifies the internal interface of the previously acquired IPsec Dosp settings.

PS C:\> $nIPSDospSetting = Get-NetIPsecDospSetting

PS C:\> $nIPSDospSettingPubNet = Where-Object –FilterScript { $_.PublicInterfaceAliases –Eq "PubNet" } –InputObject $nIPSDospSetting

PS C:\> Set-NetIPsecDospSetting –PublicInterfaceAliases PubNet2 –InputObject $nIPSDospSettingPubNet

This cmdlet can be run using only the pipeline.

PS C:\> Get-NetIPsecDospSetting | Where-Object –FilterScript { $_.PublicInterfaceAliases –Eq "PubNet" } | Set-NetIPsecDospSetting –PublicInterfaceAliases PubNet2

関連トピック

New-NetIPsecDospSetting

Remove-NetIPsecDospSetting

Set-NetIPsecDospSetting

Where-Object