Sets the URL to the specified ESI service on the current session.
Syntax
Set-EmcPublisherEndpointUrl [-ServiceUrl] <String> -ServiceName <String> [-Silent] [<CommonParameters>]
Set-EmcPublisherEndpointUrl -ServiceName <String> [-Silent] -IpAddress <String> -Port <String> [-SSL] [<CommonParameters>]
Set-EmcPublisherEndpointUrl -ServiceName <String> [-Silent] -Clear [<CommonParameters>]
Description
By default the commands in the PowerShell Toolkit connect to an instance of the specified ESI service running on localhost. This command allows a URL to another ESI service instance to be specified.
Parameters
-ServiceUrl <String>
Attributes: Required, Position: 1
Specifies the service URL.
-ServiceName <String>
Attributes: Required, Position: named
Specifies which service to use to publish the systems. The values can be esiservice (for ESI Service) or esiexchangemonitorservice (for ESI Exchange HA Extension).
-Silent <SwitchParameter>
Attributes: Optional, Position: named
Turns off all the informational and verbose messages. However, it still displays errors.
-IpAddress <String>
Attributes: Required, Position: named
Specifies the IP address of the service URL.
-Port <String>
Attributes: Required, Position: named
Specifies the port of the service URL.
-SSL <SwitchParameter>
Attributes: Optional, Position: named
Specifies whether the service URL uses the SSL protocol.
-Clear <SwitchParameter>
Attributes: Required, Position: named
Clears the service URL for this session, which causes ESI to use the default of localhost or the ServiceURL parameter to be used if the parameter is not specified on a command.
<CommonParameters>
This cmdlet supports these common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. Type get-help about_commonparameters for more details.
Examples
---------- Example 1 ----------
C:\PS>Set-EmcPublisherServiceUrl http://10.0.0.50:54500 -ServiceName esiservice
ESI Service URL successfully set to value: http://10.0.0.50:54500
This example sets the connection URL for the ESI Service.
---------- Example 2 ----------
C:\PS>Set-EmcPublisherEndpointUrl -ServiceName esiservice -IpAddress 10.0.0.50 -Port 54500 -SSL
ESI Service URL successfully set to value: https://10.0.0.50:54500
This example sets the connection URL for the ESI Service.
---------- Example 3 ----------
C:\PS>Set-EmcPublisherEndpointUrl -ServiceName esiservice -Clear
ESI Service URL on session cleared, will use default: https://localhost:54501
This example clears the current URL connection for the ESI Service and sets the connection to the default URL.