Set-DnsServerQueryResolutionPolicy

Mis à jour: mai 2015

Set-DnsServerQueryResolutionPolicy

Updates settings of a query resolution policy on a DNS server.

Syntaxe

Parameter Set: InputObject
Set-DnsServerQueryResolutionPolicy [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-PassThru] [-ThrottleLimit <Int32> ] [-ZoneName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: Server
Set-DnsServerQueryResolutionPolicy [-Name] <String> [-CimSession <CimSession[]> ] [-ClientSubnet <String> ] [-ComputerName <String> ] [-Condition <String> {AND | OR} ] [-Fqdn <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-InternetProtocol <String> ] [-PassThru] [-ProcessingOrder <UInt32> ] [-QType <String> ] [-RecursionScope <String> ] [-ServerInterfaceIP <String> ] [-ThrottleLimit <Int32> ] [-TimeOfDay <String> ] [-TransportProtocol <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: Zone
Set-DnsServerQueryResolutionPolicy [-ZoneName] <String> -Name <String> [-CimSession <CimSession[]> ] [-ClientSubnet <String> ] [-ComputerName <String> ] [-Condition <String> {AND | OR} ] [-Fqdn <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-InternetProtocol <String> ] [-PassThru] [-ProcessingOrder <UInt32> ] [-QType <String> ] [-ServerInterfaceIP <String> ] [-ThrottleLimit <Int32> ] [-TimeOfDay <String> ] [-TransportProtocol <String> ] [-ZoneScope <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Description détaillée

The Set-DnsServerQueryResolutionPolicy cmdlet updates the settings of a policy for query resolution on a Domain Name System (DNS) server.

Paramètres

-CimSession<CimSession[]>

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tels que le résultat d'une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

Alias	Session
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-ClientSubnet<String>

Specifies the client subnet criterion. Specify a criterion in the following format:

operator, value01, value02, . . . , operator, value03, value04, . . .

The operator is either EQ or NE. You can specify no more than one of each operator in a criterion.

The policy treats values that follow the EQ operator as multiple assertions which are logically combined (OR'd). The policy treats values that follow the NE operator as multiple assertions which are logically differenced (AND'd). The criterion is satisfied if the subnet of the request matches one of the EQ values and does not match any of the NE values.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-ComputerName<String>

Specifies a remote DNS server. You can specify an IP address or any value that resolves to an IP address, such as an FQDN, host name, or NETBIOS name.

Alias	Cn
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Condition<String>

Specifies how the policy treats multiple criteria. Les valeurs acceptables pour ce paramètre sont les suivantes : 

-- OR. The policy evaluates criteria as multiple assertions which are logically combined (OR'd).
-- AND. The policy evaluates criteria as multiple assertions which are logically differenced (AND'd).

The default value is AND.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-Fqdn<String>

Specifies the FQDN criterion. Specify a criterion in the following format:

operator, value01, value02, . . . , operator, value03, value04, . . .

The operator is either EQ or NE. You can specify no more than one of each operator a criterion.

The policy treats values that follow the EQ operator as multiple assertions which are logically combined (OR'd). The policy treats values that follow the NE operator as multiple assertions which are logically differenced (AND'd). The criterion is satisfied if the FQDN of the request matches one of the EQ values and does not match any of the NE values. You can include the asterisk (*) as the wildcard character. For example, EQ,*.contoso.com,NE,*.fabricam.com.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-InformationAction<System.Management.Automation.ActionPreference>

Alias	infa
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-InformationVariable<System.String>

Alias	iv
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-InternetProtocol<String>

Specifies the Internet Protocol criterion. Specify a criterion in the following format:

operator, value01, value02, . . . , operator, value03, value04, . . .

The operator is either EQ or NE. You can specify no more than one of each operator in a criterion.

The policy treats values that follow the EQ operator as multiple assertions which are logically combined (OR'd). The policy treats values that follow the NE operator as multiple assertions which are logically differenced (AND'd). The criterion is satisfied if the IP address of the request matches one of the EQ values and does not match any of the NE values.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-Name<String>

Specifies the name of the policy to modify.

Alias	none
Requis ?	true
Position ?	2
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-PassThru

Renvoie un objet qui représente l'élément sur lequel vous travaillez. Par défaut, cette applet de commande ne génère pas de sortie.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-ProcessingOrder<UInt32>

Specifies the precedence of the policy. Higher integer values have lower precedence. By default, this cmdlet adds a new policy as the lowest precedence.

If this cmdlet changes the processing order to be equal to the processing order of an existing policy, then the DNS server updates the processing order of the existing policies.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-QType<String>

Specifies the query type criterion. Specify a criterion in the following format:

operator, value01, value02, . . . , operator, value03, value04, . . .

The operator is either EQ or NE. You can specify no more than one of each operator in a criterion.

The policy treats values the follow the EQ operator as multiple assertions which are logically combined (OR'd). The policy treats values that follow the NE operator as multiple assertions which are logically differenced (AND'd). The criterion is satisfied if the type of query of the request matches one of the EQ values and does not match any of the NE values.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-RecursionScope<String>

Specifies the scope of recursion. If the policy is a recursion policy, and if a query matches it, the DNS server uses settings from this scope to perform recursion for the query.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-ServerInterfaceIP<String>

Specifies the IP address of the server interface on which the DNS server listens. Specify a criterion in the following format:

operator, value01, value02, . . . , operator, value03, value04, . . .

The operator is either EQ or NE. You can specify no more than one of each operator in the criterion.

The policy treats values the follow the EQ operator as multiple assertions which are logically combined (OR'd). The policy treats values that follow the NE operator as multiple assertions which are logically differenced (AND'd). The criterion is satisfied if the IP address of the interface matches one of the EQ values and does not match any of the NE values.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-ThrottleLimit<Int32>

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si la valeur 0 est entrée, Windows PowerShell® calcule un seuil de limitation optimal pour l'applet de commande en fonction du nombre d'applets de commande CIM exécutées sur l'ordinateur. Le seuil de limitation s'applique uniquement à l'applet de commande en cours, non pas à la session ou à l'ordinateur.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-TimeOfDay<String>

Specifies the time of day criterion. Specify a criterion in the following format:

operator, value01, value02, . . . , operator, value03, value04, . . .

The operator is either EQ or NE. You can specify no more than one of each operator in the criterion.

The policy treats values the follow the EQ operator as multiple assertions which are logically combined (OR'd). The policy treats values that follow the NE operator as multiple assertions which are logically differenced (AND'd). The criterion is satisfied if the time of day of the request matches one of the EQ values and does not match any of the NE values.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-TransportProtocol<String>

Specifies the transport protocol criterion. Specify a criterion in the following format:

operator, value01, value02, . . . , operator, value03, value04, . . .

The operator is either EQ or NE. You can specify no more than one of each operator in the string.

The policy treats values the follow the EQ operator as multiple assertions which are logically combined (OR'd). The policy treats values that follow the NE operator as multiple assertions which are logically differenced (AND'd). The criterion is satisfied if the transport protocol of the request matches one of the EQ values and does not match any of the NE values.

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-ZoneName<String>

Specifies the name of a DNS zone on which the zone level policy. The zone must exist on the DNS server.

Alias	none
Requis ?	true
Position ?	3
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-ZoneScope<String>

Specifies a list of scopes and weights for the zone. Specify the value as a string in this format:

Scope01, Weight01; Scope02, Weight02;

If you do not specify the weight, the default value is one (1).

Alias	none
Requis ?	false
Position ?	named
Valeur par défaut	none
Accepter l'entrée de pipeline ?	true(ByPropertyName)
Accepter les caractères génériques ?	false

-Confirm

Vous invite à confirmer l'exécution de l'applet de commande.

Requis ?	false
Position ?	named
Valeur par défaut	false
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-WhatIf

Indique ce qui se produit en cas d'exécution de l'applet de commande. L'applet de commande n'est pas exécutée.

Requis ?	false
Position ?	named
Valeur par défaut	false
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez  . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

<WorkflowParameters>

Entrées

Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.

Sorties

Le type de sortie correspond au type des objets que l'applet de commande émet.

• Microsoft.Management.Infrastructure.CimInstance#DnsServerPolicy

Exemples

Example 1: Add a criterion to a policy

This command adds a value for Internet protocol for the policy named PolicyMalicious. The command uses the Format-List cmdlet to control the appearance of the output. For more information, type Get-Help Format-List.

PS C:\> Set-DnsServerQueryResolutionPolicy -Name "PolicyMalicious" -InternetProtocol "eq,IPv4" -PassThru | Format-List *

Rubriques connexes

Add-DnsServerQueryResolutionPolicy

Get-DnsServerQueryResolutionPolicy

Remove-DnsServerQueryResolutionPolicy

Add-DnsServerZoneTransferPolicy