< Back

New-NSserver

Sat Jan 11, 2020 12:33 am

NAME New-NSserver



SYNOPSIS

The new-nsserver command creates a server object in the netscaler.





SYNTAX

New-NSserver -ipaddress <string> -name <string> [-comment <string>] [-returnobject <SwitchParameter>] [-session

<nitro_service>] [-state <string>] [<CommonParameters>]





DESCRIPTION

The new-nsserver command is used to create new server object in the netscaler. Currently the command requires a

nitro session object, as well as name and ip address. Other parameters are optional.





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? named

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-name <string>

Specify the name of the server object.



Required? true

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-comment <string>

Specify any comment you want to store with the object. Optional.



Required? false

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-ipaddress <string>

This mandatory parameter specifies the IP address of the server.



Required? true

Position? named

Default value

Accept pipeline input? true (ByPropertyName)

Accept wildcard characters? false



-state <string>

This parameter can be used to set the state of the server. Default is "ENABLED". Specify "DISABLED" to create

server that is disabled.



Required? false

Position? named

Default value ENABLED

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 the name of the server object.



System.String

Specify any comment you want to store with the object. Optional.



System.String

This mandatory parameter specifies the IP address of the server.



System.String

This parameter can be used to set the state of the server. Default is "ENABLED". Specify "DISABLED" to create

server that is disabled.



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.basic.server







RELATED LINKS