< Back
New-NSservice
Post
NAME New-NSservice
SYNOPSIS
The new-NSservice creates a new service on the netscaler.
SYNTAX
New-NSservice -name <string> -port <ushort> -servicetype <string> [-comment <string>] [-ip <string>] [-monitor
<string>] [-returnobject <SwitchParameter>] [-servername <string>] [-session <nitro_service>] [-state <string>]
[<CommonParameters>]
DESCRIPTION
Use the new-NSservice cmdlet to create a new service on the netscaler. Either specify the servername (server
hosting the service) or IP address of the server (which will create a matching server configuration).
PARAMETERS
-session <nitro_service>
This parameter specifies 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 (ByPropertyName)
Accept wildcard characters? false
-name <string>
Specify the name of the service. This has to be unique and can be used to search for the service, or bind it.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-comment <string>
Optional comment
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ip <string>
Specify the IP address of the server associated with this service. You have to specify either the IP or the
servername property.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-servername <string>
Specify the server name (name of the server object in NetScaler) of the server associated with this service.
You have to specify either the IP or the servername property.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-monitor <string>
Specify the name of a monitor to bind it to the service during creation.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-port <ushort>
Specify the port the destination server is listening on. Required.
Required? true
Position? named
Default value 0
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-servicetype <string>
Specify the service type. Required. Possible values = HTTP, FTP, TCP, UDP, SSL, SSL_BRIDGE, SSL_TCP, DTLS,
NNTP, RPCSVR, DNS, ADNS, SNMP, RTSP, DHCPRA, ANY, SIP_UDP, SIP_TCP, SIP_SSL, DNS_TCP, ADNS_TCP, MYSQL, MSSQL,
ORACLE, RADIUS, RADIUSListener, RDP, DIAMETER, SSL_DIAMETER, TFTP, SMPP, PPTP, GRE, SYSLOGTCP, SYSLOGUDP, FIX,
SSL_FIX, USER_TCP, USER_SSL_TCP .
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-state <string>
Specify the state of the service. Default is "ENABLED".
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 parameter specifies a nitro_service object. This can be requested using the get-nitrosession and
pipelined into this command.
System.String
Specify the name of the service. This has to be unique and can be used to search for the service, or bind it.
System.String
Optional comment
System.String
Specify the IP address of the server associated with this service. You have to specify either the IP or the
servername property.
System.String
Specify the server name (name of the server object in NetScaler) of the server associated with this service.
You have to specify either the IP or the servername property.
System.String
Specify the name of a monitor to bind it to the service during creation.
System.UInt16
Specify the port the destination server is listening on. Required.
System.String
Specify the service type. Required. Possible values = HTTP, FTP, TCP, UDP, SSL, SSL_BRIDGE, SSL_TCP, DTLS,
NNTP, RPCSVR, DNS, ADNS, SNMP, RTSP, DHCPRA, ANY, SIP_UDP, SIP_TCP, SIP_SSL, DNS_TCP, ADNS_TCP, MYSQL, MSSQL,
ORACLE, RADIUS, RADIUSListener, RDP, DIAMETER, SSL_DIAMETER, TFTP, SMPP, PPTP, GRE, SYSLOGTCP, SYSLOGUDP, FIX,
SSL_FIX, USER_TCP, USER_SSL_TCP .
System.String
Specify the state of the service. Default is "ENABLED".
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.service
RELATED LINKS
SYNOPSIS
The new-NSservice creates a new service on the netscaler.
SYNTAX
New-NSservice -name <string> -port <ushort> -servicetype <string> [-comment <string>] [-ip <string>] [-monitor
<string>] [-returnobject <SwitchParameter>] [-servername <string>] [-session <nitro_service>] [-state <string>]
[<CommonParameters>]
DESCRIPTION
Use the new-NSservice cmdlet to create a new service on the netscaler. Either specify the servername (server
hosting the service) or IP address of the server (which will create a matching server configuration).
PARAMETERS
-session <nitro_service>
This parameter specifies 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 (ByPropertyName)
Accept wildcard characters? false
-name <string>
Specify the name of the service. This has to be unique and can be used to search for the service, or bind it.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-comment <string>
Optional comment
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ip <string>
Specify the IP address of the server associated with this service. You have to specify either the IP or the
servername property.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-servername <string>
Specify the server name (name of the server object in NetScaler) of the server associated with this service.
You have to specify either the IP or the servername property.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-monitor <string>
Specify the name of a monitor to bind it to the service during creation.
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-port <ushort>
Specify the port the destination server is listening on. Required.
Required? true
Position? named
Default value 0
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-servicetype <string>
Specify the service type. Required. Possible values = HTTP, FTP, TCP, UDP, SSL, SSL_BRIDGE, SSL_TCP, DTLS,
NNTP, RPCSVR, DNS, ADNS, SNMP, RTSP, DHCPRA, ANY, SIP_UDP, SIP_TCP, SIP_SSL, DNS_TCP, ADNS_TCP, MYSQL, MSSQL,
ORACLE, RADIUS, RADIUSListener, RDP, DIAMETER, SSL_DIAMETER, TFTP, SMPP, PPTP, GRE, SYSLOGTCP, SYSLOGUDP, FIX,
SSL_FIX, USER_TCP, USER_SSL_TCP .
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-state <string>
Specify the state of the service. Default is "ENABLED".
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 parameter specifies a nitro_service object. This can be requested using the get-nitrosession and
pipelined into this command.
System.String
Specify the name of the service. This has to be unique and can be used to search for the service, or bind it.
System.String
Optional comment
System.String
Specify the IP address of the server associated with this service. You have to specify either the IP or the
servername property.
System.String
Specify the server name (name of the server object in NetScaler) of the server associated with this service.
You have to specify either the IP or the servername property.
System.String
Specify the name of a monitor to bind it to the service during creation.
System.UInt16
Specify the port the destination server is listening on. Required.
System.String
Specify the service type. Required. Possible values = HTTP, FTP, TCP, UDP, SSL, SSL_BRIDGE, SSL_TCP, DTLS,
NNTP, RPCSVR, DNS, ADNS, SNMP, RTSP, DHCPRA, ANY, SIP_UDP, SIP_TCP, SIP_SSL, DNS_TCP, ADNS_TCP, MYSQL, MSSQL,
ORACLE, RADIUS, RADIUSListener, RDP, DIAMETER, SSL_DIAMETER, TFTP, SMPP, PPTP, GRE, SYSLOGTCP, SYSLOGUDP, FIX,
SSL_FIX, USER_TCP, USER_SSL_TCP .
System.String
Specify the state of the service. Default is "ENABLED".
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.service
RELATED LINKS