Connects or adds the host, cluster, and storage systems to ESI.
Note: ESI requires the correct control station username and password for the VNX-CIFS connection. ESI does not support root for the VNX-CIFS control station connection. If necessary, you can use nasadmin or equivalent administrator username and password to connect to VNX CIFS systems.
Syntax
Connect-EmcSystem [-CreationBlob] <String> [-Refresh] [-Silent] [<CommonParameters>]
Connect-EmcSystem [-Refresh] [-Silent] -CreationParameters <Hashtable> -SystemType <String> [<CommonParameters>]
Description
The Connect-EmcSystem cmdlet is used to connect the host, cluster, and storage systems to ESI from the specified creation BLOB. You can use this cmdlet along with the Get-EmcHostSystemCredential, Get-EmcClusterSystemCredential, and Get-EmcStorageSystemCredential cmdlets to get the creation BLOB.
Parameters
-CreationBlob <String>
Attributes: Required, Position: 1
Specifies the creation BLOB, which is an encrypted connection or creation parameter BLOB. You can get the BLOB by using the Get-EmcHostSystemCredential, Get-EmcClusterSystemCredential, and Get-EmcStorageSystemCredential cmdlets.
-Refresh <SwitchParameter>
Attributes: Optional, Position: named
Specifies whether to refresh the system after connecting to it.
-Silent <SwitchParameter>
Attributes: Optional, Position: named
Turns off all the informational and verbose messages. However, it still displays errors.
-CreationParameters <Hashtable>
Attributes: Required, Position: named
Specifies the key value pair of the creation parameters for the system to be connected.
-SystemType <String>
Attributes: Required, Position: named
Specifies the storage system type. Valid values are VMAX, VNX, VNX-block, VNX-CIFS, VNXe, CLARiiON-CX4.
<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>$hBlob = Get-EmcHostSystemCredential
C:\PS>$h = $hBlob | Connect-EmcSystem
C:\PS>$h = Connect-EmcSystem -CreationBlob $hBlob
This example uses the Get-EmcHostSystemCredential cmdlet to get the creation BLOB, which is used to connect or add a host system to ESI.
-------------- Example 2 --------------
C:\PS>$cBlob = Get-EmcClusterSystemCredential
C:\PS>$c = $cBlob | Connect-EmcSystem
C:\PS>$c = Connect-EmcSystem -CreationBlob $cBlob
This example uses the Get-EmcClusterSystemCredential cmdlet to get the creation BLOB, which is used to connect or add a cluster system to ESI.
-------------- Example 3 --------------
C:\PS>$sBlob = Get-EmcStorageSystemCredential
C:\PS>$s = $sBlob | Connect-EmcSystem
C:\PS>$s = Connect-EmcSystem -CreationBlob $sBlob
This example uses the Get-EmcStorageSystemCredential cmdlet to get the creation BLOB, which is used to connect or add a storage system to ESI.
-------------- Example 4 --------------
C:\PS>$p = @{"Username"="admin";"Password"="xxx";"SpaIpAddress"="x.x.x.x";"SpbIpAddress"="x.x.x.x"; "UserFriendlyName"="VNX-x"};
C:\PS> connect-emcsystem -SystemType "vnx-block" -CreationParameters $p
This example connects a VNX-block storage system with specified parameters to ESI.
-------------- Example 5 --------------
C:\PS>$p = @{"SerialNumber"="xxx";"Host"="x.x.x.x"};
connect-emcsystem -SystemType "vmax" -CreationParameters $p
This example connects a VMAX storage system with specified parameters to ESI.
-------------- Example 6 --------------
C:\PS>$sBlob = Get-EmcStorageSystemCredential
C:\PS>$s = $sBlob | Connect-EmcSystem -Refresh
This example disables server certificate validation when using SSL to communicate with the specified ESI service.