Sets the URL to the ESI Service for the current session.
Syntax
Set-EmcServiceUrl [-ServiceUrl] <String> [-Silent] [<CommonParameters>]
Set-EmcServiceUrl [-Silent] -IpAddress <String> -Port <String> [-SSL] [<CommonParameters>]
Set-EmcServiceUrl [-Silent] -Clear [<CommonParameters>]
Description
By default the commands in the ESI Service PowerShell Toolkit connect to an instance of the ESI Service running on localhost. This command allows you to specify a URL to another ESI Service instance.
Parameters
-ServiceUrl <String>
Attributes: Required, Position: 1
Specifies the service URL.
-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 ESI Service URL.
-Port <String>
Attributes: Required, Position: named
Specifies the port of the ESI Service URL.
-SSL <SwitchParameter>
Attributes: Optional, Position: named
Specifies if the ESI Service URL uses the SSL protocol.
-Clear <SwitchParameter>
Attributes: Required, Position: named
Clears the service URL on the session, which enables ESI to use the default localhost or -ServiceURL value.
<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-EmcServiceUrl http://10.0.0.50:54500
This example sets the service URL to http://10.0.0.50:54500.
-------------- Example 2 --------------
C:\PS>Set-EmcServiceUrl -IpAddress 10.0.0.50 -Port 54500 -SSL
This example sets the service URL to https://10.0.0.50:54500, which uses the SSL protocol.
-------------- Example 3 --------------
C:\PS>Set-EmcServiceUrl -Clear
This example clears the service URL and uses the default value of https://localhost:54501.