Get-DnsServerQueryResolutionPolicy
Gets policies for query resolution from a DNS server.
Syntax
Server (Default)
Get-DnsServerQueryResolutionPolicy
[[-Name] <String>]
[-ComputerName <String>]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
Zone
Get-DnsServerQueryResolutionPolicy
[[-Name] <String>]
[-ZoneName] <String>
[-ComputerName <String>]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
Description
The Get-DnsServerQueryResolutionPolicy cmdlet gets policies for query resolution from a Domain Name System (DNS) server. Specify a zone by name to get zone level policies. If you do not specify a zone, this cmdlet gets server level policies.
Examples
Example 1: Get all zone level policies
PS C:\> Get-DnsServerQueryResolutionPolicy -ZoneName "contoso.com" | Format-List *
This command gets all the zone level policies for the zone named contoso.com.
The command uses the Format-List cmdlet to control the appearance of the output.
For more information, type Get-Help Format-List.
Example 2: Get a specific zone level policy
PS C:\> Get-DnsServerQueryResolutionPolicy -Name "NorthAmericaPolicy" -ZoneName "contoso.com" | Format-List *
Action : Allow
AppliesOn : QueryProcessing
Condition : And
Content : {DnsServerPolicyContent}
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Zone
Name : NorthAmericaPolicy
ProcessingOrder : 1
ZoneName : contoso.com
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
This command gets the zone level policy named NorthAmericaPolicy in the domain named contoso.com.
Example 3: Get all server level policies
PS C:\> Get-DnsServerQueryResolutionPolicy | Format-List *
Action : Ignore
AppliesOn : QueryProcessing
Condition : And
Content :
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Server
Name : DropPolicy
ProcessingOrder : 1
ZoneName :
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
Action : Ignore
AppliesOn : QueryProcessing
Condition : And
Content :
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Server
Name : DropPolicyMalicious
ProcessingOrder : 2
ZoneName :
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
Action : Ignore
AppliesOn : QueryProcessing
Condition : And
Content :
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Server
Name : DropPolicyQType
ProcessingOrder : 3
ZoneName :
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
Action : Allow
AppliesOn : Recursion
Condition : And
Content : {DnsServerPolicyContent}
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Server
Name : SplitBrainPolicy
ProcessingOrder : 1
ZoneName :
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
This command gets all the server level policies.
Example 4: Get a specific server level policy
PS C:\> Get-DnsServerQueryResolutionPolicy -Name "DropPolicy"
Name ProcessingOrder IsEnabled Action
---- --------------- --------- ------
DropPolicy 1 True Ignore
This command gets the server level policy named DropPolicy.
Example 5: Display all server level and zone level policies
PS C:\> $DnsServer = Get-DnsServer
PS C:\> $DnsServer.ServerPolicies | Format-List *
Action : Ignore
AppliesOn : QueryProcessing
Condition : And
Content :
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Server
Name : DropPolicy
ProcessingOrder : 1
ZoneName :
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
Action : Ignore
AppliesOn : QueryProcessing
Condition : And
Content :
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Server
Name : DropPolicyMalicious
ProcessingOrder : 2
ZoneName :
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
Action : Ignore
AppliesOn : QueryProcessing
Condition : And
Content :
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Server
Name : DropPolicyQType
ProcessingOrder : 3
ZoneName :
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
Action : Allow
AppliesOn : Recursion
Condition : And
Content : {DnsServerPolicyContent}
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Server
Name : SplitBrainPolicy
ProcessingOrder : 1
ZoneName :
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
Action : Allow
AppliesOn : QueryProcessing
Condition : And
Content : {DnsServerPolicyContent}
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Zone
Name : AmericaPolicy
ProcessingOrder : 1
ZoneName : contoso.com
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
Action : Allow
AppliesOn : QueryProcessing
Condition : And
Content : {DnsServerPolicyContent}
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Zone
Name : EuropePolicy
ProcessingOrder : 2
ZoneName : contoso.com
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
Action : Allow
AppliesOn : QueryProcessing
Condition : And
Content : {DnsServerPolicyContent, DnsServerPolicyContent}
Criteria : {DnsServerPolicyCriteria}
IsEnabled : True
Level : Zone
Name : LBPolicy
ProcessingOrder : 3
ZoneName : contoso.com
PSComputerName :
CimClass : root/Microsoft/Windows/DNS:DnsServerPolicy
CimInstanceProperties : {Action, AppliesOn, Condition, Content...}
CimSystemProperties : Microsoft.Management.Infrastructure.CimSystemProperties
The first command gets configuration settings for the current DNS server by using Get-DnsServer cmdlet, and then stores those values in the $DnsServer variable.
The second command passes the ServerPolicies property of each object stored in $DnsServer to Format-List by using the pipeline operator. This example displays both server level and zone level policies.
Example 6: Display the criteria in a DNS policy
PS C:\> $Policy = Get-DnsServerQueryResolutionPolicy -Name "SamplePolicy" -ZoneName "contoso.com"
PS C:\> $Policy.Criteria
The first command gets a policy object, and then stores it in the $Policy variable.
The second command displays the CriteriaType and Criteria in $Policy.
Parameters
-AsJob
Runs the cmdlet as a background job. Use this parameter to run commands that take a long time to complete.
The cmdlet immediately returns an object that represents the job and then displays the command prompt.
You can continue to work in the session while the job completes.
To manage the job, use the *-Job cmdlets.
To get the job results, use the Receive-Job cmdlet.
For more information about Windows PowerShell background jobs, see about_Jobs.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-CimSession
Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSession or Get-CimSession cmdlet. The default is the current session on the local computer.
Parameter properties
| Type: | CimSession[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Session |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ComputerName
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Cn |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Name
Specifies the name of the policy to get.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-ThrottleLimit
Specifies the maximum number of concurrent operations that can be established to run the cmdlet.
If this parameter is omitted or a value of 0 is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer.
The throttle limit applies only to the current cmdlet, not to the session or to the computer.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ZoneName
Specifies the name of a DNS zone from which to get the zone level policy. The zone must exist on the DNS server.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Zone
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.