Unpublishes the connection information for the specified system to the specified ESI service.
Syntax
Unpublish-EmcPublisherConnectionInfo [-ServiceUrl <String>] -UserFriendlyName <String> [-Force] -ServiceName <String> [-Silent] [-WhatIf] [-Confirm] [<CommonParameters>]
Unpublish-EmcPublisherConnectionInfo [-ServiceUrl <String>] [-Force] -ServiceName <String> [-Silent] [-WhatIf] [-Confirm] -System <RegisteredSystem> [<CommonParameters>]
Description
Unregisters the specified system from the specified ESI service.
Parameters
-ServiceUrl <String>
Attributes: Optional, Position: named
Specifies the base URL for the ESI service on which to issue the request. This must contain only the scheme, host, and port. If no value is specified, ESI uses the default of localhost or the value set by using the Set-EmcServiceUrl cmdlet.
-UserFriendlyName <String>
Attributes: Required, Position: named
Specifies the user-friendly name for the system registered with the service whose connection information needs to be removed.
-Force <SwitchParameter>
Attributes: Optional, Position: named
Allows the cmdlet to continue without asking for user confirmation
-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.
-WhatIf <SwitchParameter>
Attributes: Optional, Position: named
Describes what would happen if you executed the command without actually executing the command.
-Confirm <SwitchParameter>
Attributes: Optional, Position: named
Prompts you for confirmation before executing the command.
-System <RegisteredSystem>
Attributes: Required, Position: named
Specifies the system object that you want to unpublish or remove from the published systems list.
<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>Unpublish-EmcPublisherConnectionInfo -ServiceName esiservice -UserFriendlyName MyVNX
This example unregisters the MyVNX system from the ESI Service.
---------- Example 2 ----------
C:\PS>C:\PS> $s = Get-EmcPublisherConnectionInfo -ServiceName esiservice
C:\PS> Unpublish-EmcPublisherConnectionInfo -ServiceName esiservice -UserFriendlyName $s[0].UserFriendlyName
This example gets all of the registered systems with the ESI Service and unregisters the first system object.