Get-DnsClient

Get-DnsClient

Retrieves details of the network interfaces configured on a specified computer.

Syntax

Parameter Set: ByName
Get-DnsClient [[-InterfaceAlias] <String[]> ] [-AsJob] [-CimSession <CimSession[]> ] [-ConnectionSpecificSuffix <String[]> ] [-InterfaceIndex <UInt32[]> ] [-RegisterThisConnectionsAddress <Boolean[]> ] [-ThrottleLimit <Int32> ] [-UseSuffixWhenRegistering <Boolean[]> ] [ <CommonParameters>]

Detaillierte Beschreibung

The Get-DnsClient cmdlet retrieves configuration details specific to the different network interfaces on a specified computer.

Parameter

-AsJob

-CimSession<CimSession[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-ConnectionSpecificSuffix<String[]>

Specifies the connection-specific suffixes that are to be appended. This parameter is a per-connection DNS suffix which will be appended to the computer name to construct a Fully Qualified Domain Name (FQDN). This FQDN will be used as the host name for name resolution by the DNS client.

-InterfaceAlias<String[]>

Specifies the friendly name of the interface.

-InterfaceIndex<UInt32[]>

Specifies the index number of the interface.

-RegisterThisConnectionsAddress<Boolean[]>

Specifies the registration policy for this interface.
This parameter specifies that the computer should automatically register the IP address associated with this connection with the DNS server.

-ThrottleLimit<Int32>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

-UseSuffixWhenRegistering<Boolean[]>

Specifies the registration suffix policy for this interface.
This parameter specifies that suffixes need to be used while registering an IP address.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

• Microsoft.Management.Infrastructure.CimInstance#root\StandardCimv2\MSFT_DNSClient

  Das Microsoft.Management.Infrastructure.CimInstance-Objekt ist eine Wrapperklasse, die Objekte der Windows-Verwaltungsinstrumentation (WMI) anzeigt. Der Pfad nach dem Nummernzeichen (#) stellt den Namespace und den Klassennamen des zugrunde liegenden WMI-Objekts bereit.

• Microsoft.Management.Infrastructure.CimInstance#root\StandardCimv2\MSFT_DNSClientServerAddress

  Das Microsoft.Management.Infrastructure.CimInstance-Objekt ist eine Wrapperklasse, die Objekte der Windows-Verwaltungsinstrumentation (WMI) anzeigt. Der Pfad nach dem Nummernzeichen (#) stellt den Namespace und den Klassennamen des zugrunde liegenden WMI-Objekts bereit.

• Microsoft.Management.Infrastructure.CimInstance#root\StandardCimv2\MSFT_NetAdapter

  Das Microsoft.Management.Infrastructure.CimInstance-Objekt ist eine Wrapperklasse, die Objekte der Windows-Verwaltungsinstrumentation (WMI) anzeigt. Der Pfad nach dem Nummernzeichen (#) stellt den Namespace und den Klassennamen des zugrunde liegenden WMI-Objekts bereit.

• Microsoft.Management.Infrastructure.CimInstance#root\StandardCimv2\MSFT_NetIPInterface

  Das Microsoft.Management.Infrastructure.CimInstance-Objekt ist eine Wrapperklasse, die Objekte der Windows-Verwaltungsinstrumentation (WMI) anzeigt. Der Pfad nach dem Nummernzeichen (#) stellt den Namespace und den Klassennamen des zugrunde liegenden WMI-Objekts bereit.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• Microsoft.Management.Infrastructure.CimInstance#root\StandardCimv2\MSFT_DNSClient

  Das Microsoft.Management.Infrastructure.CimInstance-Objekt ist eine Wrapperklasse, die Objekte der Windows-Verwaltungsinstrumentation (WMI) anzeigt. Der Pfad nach dem Nummernzeichen (#) stellt den Namespace und den Klassennamen des zugrunde liegenden WMI-Objekts bereit.

Beispiele

EXAMPLE 1

This example gets configuration details of network interfaces on a computer.

PS C:\> Get-DnsClient

EXAMPLE 2

This example sets the DNS server IP address on all of the wired Ethernet connections on a computer.

PS C:\> $dnsClient1 = Get-DnsClient -InterfaceAlias "Wired Ethernet Connection"

PS C:\> Set-DnsClientServerAddress –InputObject $dnsClinet1 -ServerAddresses ("10.0.0.1","10.0.0.2")

This is a version of the cmdlet using the pipeline.

PS C:\> Get-DnsClient | Set-DnsClientServerAddress -ServerAddresses ("10.0.0.1","10.0.0.2")

EXAMPLE 3

This example resets all of the network interfaces to use DHCP-specified DNS server addresses.

PS C:\> Get-DnsClient | Set-DnsClientServerAddress -ResetServerAddresses

Verwandte Themen

Register-DnsClient

Set-DnsClient