New-NSnameserver

NAME New-NSnameserver



SYNOPSIS

The new-nsnameserver sets the nameserver





SYNTAX

New-NSnameserver [[-session] <nitro_service>] [-dnsvservername] <string> [[-type] <string>] [[-dnsprofilename]

<string>] [-returnobject <SwitchParameter>] [<CommonParameters>]



New-NSnameserver [[-session] <nitro_service>] [-ip] <string> [[-local] <bool>] [[-type] <string>]

[[-dnsprofilename] <string>] [-returnobject <SwitchParameter>] [<CommonParameters>]





DESCRIPTION

use new-nsnameserver to set the initial nameserver





PARAMETERS

-session <nitro_service>

This mandatory parameter requires a nitro_service object. This can be requested using the get-nitrosession and

pipelined into this command.



Required? false

Position? 0

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-dnsvservername <string>

Specify a DNS LB vserver. If using this, don't specify the IP address parameter.



Required? true

Position? 1

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-ip <string>

Specify the IP address of the DNS server. Do not specify the dnsvservername parameter if using the IP address.



Required? true

Position? 1

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-local <bool>

Specify if the IP address refers to an IP address owned by the NetScaler that can do recursive lookups. Not

used with the dnsvservername parameter.



Required? false

Position? 2

Default value False

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-type <string>

type, typically UDP



Required? false

Position? 3

Default value UDP

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-dnsprofilename <string>

specify a DNS profile if required



Required? false

Position? 4

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-returnobject <SwitchParameter>

If set to true, the object that is created is returned. This is useful to testing purposes.



Required? false

Position? named

Default value False

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

com.citrix.netscaler.nitro.service.nitro_service

This mandatory parameter requires a nitro_service object. This can be requested using the get-nitrosession and

pipelined into this command.



System.String

Specify a DNS LB vserver. If using this, don't specify the IP address parameter.



System.String

Specify the IP address of the DNS server. Do not specify the dnsvservername parameter if using the IP address.



System.Boolean

Specify if the IP address refers to an IP address owned by the NetScaler that can do recursive lookups. Not

used with the dnsvservername parameter.



System.String

type, typically UDP



System.String

specify a DNS profile if required



System.Management.Automation.SwitchParameter

If set to true, the object that is created is returned. This is useful to testing purposes.





OUTPUTS

com.citrix.netscaler.nitro.resource.config.dns.dnsnameserver





---------- EXAMPLE 1 ----------



new-nsnameserver -dnsvserveranem "dns-lb"



set the dns-lb load balancer as the DNS server

---------- EXAMPLE 2 ----------



new-nsnameserver -ip "10.123.45.6" -type "UDP" -returnobject $true



set 10.123.45.6 as a DNS server, use UDP and output the name server object.



RELATED LINKS