- Reference
- Module:
- DnsClient
Performs a DNS name query resolution for the specified name.
Syntax
Resolve-DnsName [-Name] <String> [[-Type] <RecordType>] [-Server <String[]>] [-DnsOnly] [-CacheOnly] [-Dnsseco*k] [-DnssecCd] [-NoHostsFile] [-LlmnrNetbiosOnly] [-LlmnrFallback] [-LlmnrOnly] [-NetbiosFallback] [-NoIdn] [-NoRecursion] [-QuickTimeout] [-TcpOnly] [<CommonParameters>] Description
The Resolve-DnsName cmdlet performs a DNS query for the specified name.This cmdlet is functionally similar to the nslookup tool which allows users to query for names.
Examples
EXAMPLE 1
PS C:\> Resolve-DnsName -Name www.bing.comThis example resolves a name using the default options.
EXAMPLE 2
PS C:\> Resolve-DnsName -Name www.bing.com -Server 10.0.0.1This example resolves a name against the DNS server at 10.0.0.1.
EXAMPLE 3
PS C:\> Resolve-DnsName -Name www.bing.com -Type AThis example queries for A type records for name www.bing.com.
EXAMPLE 4
PS C:\> Resolve-DnsName -Name www.bing.com -DnsOnlyThis example resolves a name using only DNS.LLMNR and NetBIOS queries are not issued.
Parameters
-CacheOnly
Resolves this query using only the local cache.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DnsOnly
Resolves this query using only the DNS protocol.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DnssecCd
Sets the DNSSEC checking-disabled bit for this query.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Dnsseco*k
Sets the DNSSEC OK bit for this query.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LlmnrFallback
Allows falling back to the LLMNR protocol when resolving this query with DNS fails.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LlmnrNetbiosOnly
Resolves this query using only the LLMNR or NetBIOS protocols.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LlmnrOnly
Resolves this query using only the LLMNR protocol.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifies the name to be resolved.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NetbiosFallback
Allows fallback to the NetBIOS protocol when resolving this query with DNS fails.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoHostsFile
Skips the hosts file when resolving this query.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoIdn
Specifies not to use IDN encoding logic for the query.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoRecursion
Instructs the server not to use recursion when resolving this query.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-QuickTimeout
Uses shorter timeouts for this query.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Server
Specifies the IP addresses or host names of the DNS servers to be queried.By default the interface DNS servers are queried if this parameter is not supplied.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TcpOnly
Uses only TCP for this query.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Type
Specifies the DNS query type that is to be issued.By default the type is A_AAAA, the A and AAAA types will both be queried.The acceptable values for this parameter are:
-- UNKNOWN = 0,
-- A_AAAA = 0, the DNS query type is A_AAAA.
-- A = 1, the DNS query type is IPv4 server Address.
-- AAAA = 28, the DNS query type is IPv6 server address.
-- NS = 2, the DNS query type is name server.
-- MX = 15, the DNS query type is mail routing information.
-- MD = 3, the DNS query type is mail destination.
-- MF = 4, the DNS query type is mail forwarder.
-- CNAME = 5, the DNS query type is canonical name.
-- SOA = 6, the DNS query type is start of authority zone.
-- MB = 7, the DNS query type is mailbox domain name.
-- MG = 8, the DNS query type is mail group member.
-- MR = 9, the DNS query type is mail rename name.
-- NULL = 10, the DNS query type is null resource record.
-- WKS = 11, the DNS query type is well known service.
-- PTR = 12, the DNS query type is domain name pointer.
-- HINFO = 13, the DNS query type is host information.
-- MINFO = 14, the DNS query type is mailbox information.
-- TXT = 16, the DNS query type is text strings.
-- RP = 17, the DNS query type is responsible person.
-- AFSDB = 18, the DNS query type is AFS database servers.
-- X25 = 19, the DNS query type is packet switched wide area network.
-- ISDN = 20, the DNS query type is Integrated Services Digital Network.
-- RT = 21, the DNS query type is DNS route through.
-- SRV = 33, the DNS query type is server selection.
-- DNAME = 39, the DNS query type is domain aliases.
-- OPT = 41, the DNS query type is DNS option.
-- DS = 43, the DNS query type is delegation signer.
-- RRSIG = 46, the DNS query type is DNSSEC signature.
-- NSEC = 47, the DNS query type is next-secure record.
-- DNSKEY = 48, the DNS query type is DNS key record.
-- DHCID = 49, the DNS query type is Dynamic Host Configuration Protocol information.
-- NSEC3 = 50, the DNS query type is NSEC record version 3.
-- NSEC3PARAM = 51, the DNS query type is NSEC3 parameters.
-- ANY = 255, the DNS query type is wildcard match.
-- ALL = 255, the DNS query type is wildcard match.
| Type: | RecordType |
| Accepted values: | UNKNOWN, A_AAAA, A, NS, MD, MF, CNAME, SOA, MB, MG, MR, NULL, WKS, PTR, HINFO, MINFO, MX, TXT, RP, AFSDB, X25, ISDN, RT, AAAA, SRV, DNAME, OPT, DS, RRSIG, NSEC, DNSKEY, DHCID, NSEC3, NSEC3PARAM, ANY, ALL, WINS |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Inputs
None
Outputs
Microsoft.DnsClient.Commands.DnsRecord
The DnsRecord object contains all of the records returned from the wire for the specified DNS query.
- Nslookup on TechNet
