Removes the registration of, or unregisters, a specified storage system with the ESI Service.
Syntax
Remove-EmcSystem -SystemName <String> [-Force] [-ServiceUrl <String>] [-Silent] [-WhatIf] [-Confirm] [<CommonParameters>]
Remove-EmcSystem [-Force] [-ServiceUrl <String>] [-Silent] [-WhatIf] [-Confirm] -System <RegisteredSystem> [<CommonParameters>]
Parameters
-SystemName <String>
Attributes: Required, Position: named
Specifies the name of the system you want to unregister.
-Force <SwitchParameter>
Attributes: Optional, Position: named
Allows the cmdlet to continue without asking for user confirmation.
-ServiceUrl <String>
Attributes: Optional, Position: named
Specifies the base URL for the ESI Service. 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.
-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
Shows what would happen if the cmdlet runs. The cmdlet is not run.
-Confirm <SwitchParameter>
Attributes: Optional, Position: named
Prompts you for confirmation before executing the command.
-System <RegisteredSystem>
Attributes: Required, Position: named, accepts pipeline input (by value)
Specifies the system object you want to unregister.
<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>Remove-EmcSystem -SystemName MyVNX
This example unregisters the system with the name MyVNX.
-------------- Example 2 --------------
C:\PS>$s = Get-EmcSystem
C:\PS> Remove-EmcSystem -System $s[0]
This example gets all the registered systems and unregisters the first system object.