Add-DnsServerResponseRateLimitingExceptionlist

Add-DnsServerResponseRateLimitingExceptionlist

Adds an RRL exception list on the DNS server.

構文

Parameter Set: Add0
Add-DnsServerResponseRateLimitingExceptionlist [[-Name] <String> ] [[-ClientSubnet] <String> ] [[-Fqdn] <String> ] [[-ServerInterfaceIP] <String> ] [[-Condition] <String> {AND | OR} ] [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-InformationAction <ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <String> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

詳細説明

The Add-DnsServerResponseRateLimiting cmdlet adds a Response Rate Limiting (RRL) exception list on the DNS server. The RRL exception list indicates that responses to queries for specified Fully Qualified Domain Names (FQDNs), queries originating from specified client subnets, queries received on specified server interfaces, or any combination of these values, are exempt from RRL.

パラメーター

-CimSession<CimSession[]>

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

-ClientSubnet<String>

Specifies the client subnet values for the exception list.

This parameter must have the following format: COMPARATOR, value1, value2,..., COMPARATOR, value 3, value 4,.. where the COMPARATOR can be EQ or NE. There can be only one EQ and one NE in a value.

The values following the EQ operator will be treated as multiple assertions which are logically combined using the OR operator. The values following the NE operator will be treated as multiple assertions which are logically differenced using the AND operator.

Multiple values are combined using the Condition parameter as a logical operator. The same operator is also used for combining EQ and NE expressions within a value.

For example, EQ, America, Asia, NE, Europe specifies that the client subnets of America and Asia are in the exception list, and the client subnet of Europe is not.

For details, see Add-DnsServerClientSubnet.

-ComputerName<String>

Specifies a remote DNS server on which to run the command. You can specify an IP address or any value that resolves to an IP address, such as a fully qualified domain name (FQDN), host name, or NetBIOS name.

-Condition<String>

Specifies a logical operator for combining multiple values of the ClientSubnet, Fdqn and ServerIp parameters. The values for the parameters are combined using the Condition parameter as a logical operator. The same operator is also used for combining EQ and NE expressions within a value. The default value is AND.

-Fqdn<String>

Specifies FQDN values for the exception list.

The value must have the following format: COMPARATOR, value1, value2,..., COMPARATOR, value 3, value 4,.. where the COMPARATOR can be EQ or NE. There can be only one EQ and one NE in a value.

The values following the EQ operator will be treated as multiple assertions which are logically combined using the OR operator. The values following the NE operator will be treated as multiple assertions which are logically differenced using the AND operator.

Multiple values are combined using the Condition parameter as a logical operator. The same operator is also used for combining EQ and NE expressions within a value.

For example, EQ,*.contoso.com specifies that the contoso.com domain should be added to the exception list.

-InformationAction<ActionPreference>

Specifies how this cmdlet responds to an information event. このパラメーターに指定できる値は、次のとおりです。

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend

-InformationVariable<String>

Specifies a variable in which to store an information event message.

-Name<String>

Specifies the name of the RRL exception list.

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットから出力は生成されません。

-ServerInterfaceIP<String>

Specifies the server interface on which the DNS server is listening.

The value must have the following format: COMPARATOR, value1, value2,..., COMPARATOR, value 3, value 4,.. where the COMPARATOR can be EQ or NE. There can be only one EQ and one NE in a value.

The values following the EQ operator are treated as multiple assertions which are logically combined using the OR operator. The values following the NE operator are treated as multiple assertions which are logically differenced using the AND operator.

Multiple values are combined using the Condition parameter as a logical operator. The same operator is also used for combining EQ and NE expressions within a value.

For example, EQ,10.0.0.3 specifies that all queries received on a server interface that has the IP address of 10.0.0.3 should be exempt from RRL.

-ThrottleLimit<Int32>

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

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

-WhatIf

コマンドレットが実行された場合に何が起きるのかを示します。コマンドレットは実行されません。

<CommonParameters>

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

<WorkflowParameters>

入力

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

出力

出力型は、コマンドレットが出力するオブジェクトの型です。

• Microsoft.Management.Infrastructure.CimInstance#DnsServerResponseRateLimitingExceptionlist

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

使用例

Example 1: Add a domain to an RRL exception list

This command adds an RRL exception for the domain contoso.com.

PS C:\> Add-DnsServerResponseRateLimitingExceptionlist -Name "SafeList1" -Fqdn "EQ,*.contoso.com"                        

関連項目

Add-DnsServerClientSubnet

Get-DnsServerResponseRateLimitingExceptionlist

Set-DnsServerResponseRateLimiting

Set-DnsServerResponseRateLimitingExceptionlist