Editar

Set-HcsDnsClientServerAddress

  • Reference
Module:
HCS

Sets the server addresses for a Domain Name System (DNS) client device.

Syntax

Set-HcsDnsClientServerAddress
   [-PrimaryIPv4 <IPAddress>]
   [-PrimaryIPv6 <IPAddress>]
   [-SecondaryIPv4 <IPAddress[]>]
   [-SecondaryIPv6 <IPAddress[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-HcsDnsClientServerAddress cmdlet sets the server addresses for a DNS client device.

Examples

Example 1: Set the primary DNS address

PS C:\> Set-HcsDnsClientServerAddress -PrimaryIPv4 
192.168.200.239

PrimaryIPv4                   PrimaryIPv6                   SecondaryIPv4                 SecondaryIPv6
-----------                   -----------                   -------------                 -------------
192.168.200.239                                             {192.168.10.29, 192.168.10.28}{}

This command specifies the PrimaryIPv4 parameter to set the primary IPv4 DNS server address for a client.

Example 2: Set the address for two secondary DNS servers

PS C:\> Set-HcsDnsClientServerAddress -SecondaryIPv4 
192.168.10.29,192.168.10.28

PrimaryIPv4                   PrimaryIPv6                   SecondaryIPv4                 SecondaryIPv6
-----------                   -----------                   -------------                 -------------
192.68.200.239                                              {192.68.10.29, 192.68.10.28}  {}

This command specifies the SecondaryIPv4 parameter to set two secondary IPv4 DNS server addresses for a client.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrimaryIPv4

Specifies the primary IPv4 server address for a DNS client.

Type:IPAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrimaryIPv6

Specifies the primary IPv6 server address for a DNS client.

Type:IPAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecondaryIPv4

Specifies an array of secondary IPv4 server addresses for a DNS client. If the client cannot resolve the primary server, it uses a secondary server address.

Type:IPAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecondaryIPv6

Specifies an array of secondary IPv6 server addresses for a DNS client. If the client cannot resolve the primary server, it uses a secondary server address.

Type:IPAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.HCS.Management.Powershell.Cmdlets.DnsInfo

The DnsInfo object has the following properties:

  • IPAddress PrimaryIPv4
  • IPAddress PrimaryIPv6
  • IPAddress[] SecondaryIPv4
  • IPAddress[] SecondaryIPv6