Using the IBM Storage Automation Plug-in for PowerShell

Use the IBM® Storage Automation Plug-in for PowerShell to run storage provisioning cmdlets in the PowerShell environment.

After the IBM Storage Plug-in is deployed (see Downloading and installing the plug-in package for PowerShell), the storage-related cmdlets become available for PowerShell users, as detailed in the table below.

Table 1. Cmdlets available via IBM Storage Automation Plug-in for PowerShell
Object/URI Description Syntax and parameters
SCBConnection Set up the connection between the Spectrum Control Base server and the IIBM Storage Automation Plug-in for PowerShell. Before using the PowerShell client, create a PowerShell interface user. New-SCBConnection -ConnectionUri <String> [-Credential] <PSCredential> [<CommonParameters>]

New-SCBConnection -ConnectionUri <String> [-UserName] <String> [-Password] <String> [<CommonParameters>]

  • ConnectionUrl <String> Alias L. The connection URL for SCB server in the https://SCBIPAddress:ServicePort(8440) format.
  • Credentials <PSCredential>. User credentials for connection to the SCB server.
  • UserName <String>Alias U. User name and password for the SCB server connection must be specified. The user can be created on the Spectrum Control Base GUI, when creating a PowerShell interface. Other non-PowerShell-interface users are limited to access some SCB functions.
  • Password <String> Alias P. The corresponding password.
For example, connect to the Spectrum Control Base server at 9.115.250.45 with user name powershell and password admin2:
PS C:\>$client=New-SCBConnection -ConnectionUri https://9.115.250.45:8440
 -UserName powershell -Password admin2
Note: If the token is expired, re-issue New-SCBClient to establish a new connection.
SCBSpace Retrieve information about all storage spaces or show the detailed information according to space ID or name. Get-SCBSpace [[-SpaceID] <String>] [-SCBConnection <SCBConnection>] [<CommonParameters>]

Get-SCBSpace [-SpaceName] <String> [-SCBConnection <SCBConnection>] [<CommonParameters>]

  • SpaceID <String>. Get the space details via the space ID.
  • SpaceName <String>. Get the space details via the space name.
  • SCBConnection <SCBConnection>The client handle for SCB server.

    It can be created via New-SCBConnection. If the SCBConnection is not specified, a most recently used SCBConnection is utilized by default. The connection can be found via the global variable $Global:DefaultConnection. If multiple SCB servers are connected, you must explicitly specify the SCBConnection parameter.

For example, display the detailed information, using space ID:
PS C:\>Get-SCBSpace -SCBConnection $client 
-SpaceID efbd54ac-70c8-4693-ad7f-3df1cf56c187

id : efbd54ac-70c8-4693-ad7f-3df1cf56c187
num_services : 0
unique_identifier : efbd54ac-70c8-4693-ad7f-3df1cf56c187
name : Default_Space
description : Space used as the default.
storage_array_metadata : {}
SCBService Retrieve information about storage services delegated to the existing PowerShell interfaces. Get-SCBService [[-ServiceID] <String>] [-SCBConnection <SCBConnection>] [<CommonParameters>]

Get-SCBService [-ServiceName <String>] [-SCBConnection <SCBConnection>] [<CommonParameters>]

Get-SCBService [-SpaceID <String>] [-SCBConnection <SCBConnection>] [<CommonParameters>]

Get-SCBService [-SpaceName <String>] [-SCBConnection <SCBConnection>] [<CommonParameters>]

  • ServiceID <String>. The service ID or its unique identifier.
  • ServiceName <String>. The service name.
  • SpaceID <String>. Retrieve service information via its storage space ID.
  • SpaceName <String>. Retrieve service information via its storage space name.
  • SCBConnection <SCBConnection>The client handle for Spectrum Control Base server.

    It can be created via New-SCBConnection. If the SCBConnection is not specified, a most recently used SCBConnection is utilized by default. The connection can be found via the global variable $Global:DefaultConnection. If multiple SCB servers are connected, you must explicitly specify the SCBConnection parameter.

For example, display the detailed information, using service ID:
PS C:\>Get-SCBService f69be4d0-b56c-449b-a3ae-a727a6ba972d 
-SCBConnection $client

id : f69be4d0-b56c-449b-a3ae-a727a6ba972d
unique_identifier : f69be4d0-b56c-449b-a3ae-a727a6ba972d
name : service_vvol
description :
container : 7af7432d-172d-495b-a287-a1df2d2f4b77
capability_values :
type : vvol
physical_size : 214748364800
logical_size : 214748364800
physical_free : 214748364800
logical_free : 214748364800
total_capacity : 214748364800
used_capacity : 0
max_resource_logical_free : 214748364800
max_resource_free_size_for_provisioning : 214748364800
num_volumes : 0
has_admin : True
SCBHost Retrieve information about hosts. Get-SCBHost [[-HostID] <String>] [-SCBConnection <SCBConnection>] [<CommonParameters>]

Get-SCBHost [-ArrayID] <String> [-HostName] <String> [-SCBConnection <SCBConnection>] [<CommonParameters>]

Get-SCBHost [-ArrayID] <String> [-Initiator] <Object> [-SCBConnection <SCBConnection>] [<CommonParameters>]

Get-SCBHost [-ArrayID] <String> [-SCBConnection <SCBConnection>] [<CommonParameters>]

  • HostID <String>. The host ID unique to the Spectrum Control Base server.
  • ArrayID <String>. The ID of the managed storage system.
  • HostName <String>. The host name. This string is case-sensitive.
  • Initiators <Object>. iSCSI or FC ports of the host.
  • SCBConnection <SCBConnection>The client handle for Spectrum Control Base server.

    It can be created via New-SCBConnection. If the SCBConnection is not specified, a most recently used SCBConnection is utilized by default. The connection can be found via the global variable $Global:DefaultConnection. If multiple SCB servers are connected, you must explicitly specify the SCBConnection parameter.

For example, display the detailed information about a single host:
PS C:\>Get-SCBHost -ID 6

id : 6
array_type : 2145
array : 00000200AE62F4E4
name : fakeFCHost
port_count : 2
iogroup_count : 4
status : offline
host_type : generic
storage_cluster :
physical_host :
iogroups : {2, 3, 4, 1}
initiators : {21000024FF2DAFF6, 21000024FF2DAFF5}
SCBVolume Perform volume operations:
  • Retrieve information about volumes managed by the PowerShell interfaces.
  • Create a volume via the services delegated to the PowerShell interface.
  • Resize a volume.
  • Remove a volume.

Get

Get-SCBVolume [[-VolumeID] <String>] [[-SCBConnection] <SCBConnection>] [<CommonParameters>]

Get-SCBVolume [-VolumeName] <String> [[-ArrayID] <String>] [-SCBConnection <SCBConnection>] [<CommonParameters>]

Get-SCBVolume [-ArrayID] <String> [<CommonParameters>] Get-SCBVolume [-ServiceID] <String> [-SCBConnection <SCBConnection>] [<CommonParameters>]

Get-SCBVolume [-ScsiID] <String> [-SCBConnection <SCBConnection>] [<CommonParameters>]

  • VolumeID <String>. The volume ID, its unique identifier or alias ID.
  • VolumeName <String>. The volume name or alias name. The VolumeName is not unique, especially when multiple storage systems are managed by same Spectrum Control Base instance. To identify the volume on certain storage system, the combination VolumeName and ArrayID can be used.
  • ArrayID <String>. The ID of the managed storage system. This parameter can be used separately, or together with VolumeName.
  • ServiceID <String>. The ID of the service managing the volume.
  • SCBConnection <SCBConnection>The client handle for SCB server.

    It can be created via New-SCBConnection. If the SCBConnection is not specified, a most recently used SCBConnection is utilized by default. The connection can be found via the global variable $Global:DefaultConnection. If multiple SCB servers are connected, you must explicitly specify the SCBConnection parameter.

For example, retrieve detailed information of a volume on a managed storage system:
PS C:\>Get-SCBVolume -VolumeName SCBVOL304 -ArrayID 00000200AE62F4E4 
-SCBConnection $client
scsi_identifier : 6005076802B98BD390000000000000AD
array_type : 2145
array : 00000200AE62F4E4
array_name : V7K_71
id : 6005076802B98BD390000000000000AD
pool_name : SCB61_THIN
pool_id : 3
max_extendable_size : 6596353938773
service_compliance : True
domain_name :
service_name : ThinProvisionService
container_name : DemoSpace
service_id : 8d4b6c91-670f-40bd-8d69-901e4a1219f9
container_id : 4cfc8298-965f-4f90-b23f-4d04fe70d9ee
storage_model : Storwize V7000
volume_id : 24
name : SCBVOL304
logical_capacity : 10737418240
   

New

New-SCBVolume [-VolumeName] <String> [-Size] <Int64> [[-SizeUnit] <String>] [-ServiceID] <String> [[-Initiator] <Object>] [[-SCBConnection] <SCBConnection>] [<CommonParameters>]

  • VolumeName <String>. The name of a new volume.
  • Size <Int64>. The size of a new volume. This parameter is together with SizeUnit.
  • SizeUnit <String>. The unit of the new volume size (Byte, GB, GiB, TiB). Default setting is GB.
  • ServiceID <String>. The ID of the service managing the volume.
  • Initiators <Object>. iSCSI or FC ports of the host to be mapped to the new volume. System.Collections.ArrayList object or just a Object[] can be used for multiple initiators.
  • SCBConnection <SCBConnection>The client handle for SCB server.

    It can be created via New-SCBConnection. If the SCBConnection is not specified, a most recently used SCBConnection is utilized by default. The connection can be found via the global variable $Global:DefaultConnection. If multiple SCB servers are connected, you must explicitly specify the SCBConnection parameter.

For example, create a new volume for a specific service:
PS C:\>New-SCBVolume -Name DemoThin04 -Size 1 -SizeUnit GiB -ServiceID 
$service.id |ft array_name,id,name,pool_name,service_name,
logical_capacity
array_name : cim75
id : 6005076801A707416800000000000B76
name : DemoThin04
pool_name : SCBReserved
service_name : SVCThinService
container_name : DemoSpace
logical_capacity : 1073741824

Resize

Resize-SCBVolume [-VolumeID] <String> [-NewSize] <Int64> [[-SizeUnit] <String>] [-SCBConnection <SCBConnection>] [<CommonParameters>]

  • VolumeID <String>. ID of the volume to be resized.
  • NewSize <Int64>. The new size of the volume. This parameter is together with SizeUnit.
  • SizeUnit <String>. The unit of the new volume size (Byte, GB, GiB, TiB). Default setting is GB.
  • SCBConnection <SCBConnection>The client handle for SCB server.

    It can be created via New-SCBConnection. If the SCBConnection is not specified, a most recently used SCBConnection is utilized by default. The connection can be found via the global variable $Global:DefaultConnection. If multiple SCB servers are connected, you must explicitly specify the SCBConnection parameter.

For example, create a new volume for a specific service:
Resize-SCBVolume -ID 6005076801A707416800000000000B76 -NewSize 2 
-SizeUnit GiB|ft name,id,logical_capacity

name id logical_capacity
---- -- ----------------
DemoThin03 6005076801A707416800000000000B74      2147483648
   

Remove

Remove-SCBVolume [-VolumeID] <Object> [[-Force]] [-SCBConnection <SCBConnection>] [<CommonParameters>]

  • VolumeID <String>. ID of the volume to be removed.
  • Force <SwitchParameter>. Deletes mapping relations of the volume to be removed.
  • SCBConnection <SCBConnection>The client handle for SCB server.

    It can be created via New-SCBConnection. If the SCBConnection is not specified, a most recently used SCBConnection is utilized by default. The connection can be found via the global variable $Global:DefaultConnection. If multiple SCB servers are connected, you must explicitly specify the SCBConnection parameter.

For example, remove a volume:
PS C:\>Remove-SCBVolume -VolumeID 6005076801A707416800000000000B85 
-SCBConnection $client

True
SCBHostVol
Mapping		 Perform volume mapping operations:
  • Retrieve information about host-volume mapping.
  • Map the volume to the host.
  • Unmap the volume from the host.

Get

Get-SCBHostVolMapping [[-HostVolMappingID] <String>] [-SCBConnection <SCBConnection>] [<CommonParameters>]

Get-SCBHostVolMapping [-HostID] <String> [-SCBConnection <SCBConnection>] [<CommonParameters>]

Get-SCBHostVolMapping [-VolumeID] <String> [-SCBConnection <SCBConnection>] [<CommonParameters>]

  • HostVolMappingID <String>. The mapping relation ID, its unique identifier or alias ID.
  • HostID <String>. Displays mapping relations of the host with the specified ID.
  • VolumeID <String>. Displays mapping relations of the volume with the specified ID.
  • SCBConnection <SCBConnection>The client handle for SCB server.

    It can be created via New-SCBConnection. If the SCBConnection is not specified, a most recently used SCBConnection is utilized by default. The connection can be found via the global variable $Global:DefaultConnection. If multiple SCB servers are connected, you must explicitly specify the SCBConnection parameter.

For example, display mapping relations for the host with ID 5:
PS C:\>Get-SCBHostVolMapping -HostID 5 -SCBConnection $sc|ft

id volume host lun_number
-- ------ ---- ----------
113 6005076802B98BD390000000000000AC 5 2
3 6005076802B98BD39000000000000018 5 1
4 6005076802B98BD39000000000000017 5 0
111 6005076802B98BD390000000000000AB 5 7
107 6005076802B98BD390000000000000A8 5 5
   

New

New-SCBHostVolMapping [-VolumeID] <String> [-HostID] <Object> [-SCBConnection <SCBConnection>] [<CommonParameters>]

New-SCBHostVolMapping [-VolumeID] <String> [-HostName] <String> [-SCBConnection <SCBConnection>] [<CommonParameters>]

New-SCBHostVolMapping [-VolumeID] <String> [-Initiators] <String> [-SCBConnection <SCBConnection>] [<CommonParameters>]

  • VolumeID <String>. ID of the volume to be mapped.
  • HostID <String>. ID of the host that the specified volume will be mapped to.
  • Initiators <Object>. The host endpoint (iSCSI or FC).
  • SCBConnection <SCBConnection>The client handle for SCB server.

    It can be created via New-SCBConnection. If the SCBConnection is not specified, a most recently used SCBConnection is utilized by default. The connection can be found via the global variable $Global:DefaultConnection. If multiple SCB servers are connected, you must explicitly specify the SCBConnection parameter.

For example, map a single volume to multiple hosts:
PS C:\>New-SCBHostVolMapping -VolumeID 6005076801A707416800000000000B76 
-HostIDs 22,21,1

{@{id=21; volume=6005076801A707416800000000000B76; host=22; 
lun_number=1}}{@{id=21; volume=6005076801A707416800000000000B76; host=22; 
lun_number=4}, @{id=20;
volume=6005076801A707416800000000000B76; host=21; lun_number=4}, @{id=19;

Remove

Remove-SCBHostVolMapping [-VolumeID] <String> [-HostID] <Object> [-SCBConnection <SCBConnection>] [<CommonParameters>]

Remove-SCBHostVolMapping [-VolumeID] <String> [-HostName] <String> [-SCBConnection <SCBConnection>] [<CommonParameters>]

Remove-SCBHostVolMapping [-VolumeID] <String> [-Initiators] <String> [-SCBConnection <SCBConnection>] [<CommonParameters>]

  • VolumeID <String>. ID of the volume to be unmapped.
  • HostID <String>. ID of the host that the specified volume will be unmapped from.
  • Initiators <Object>. The host endpoint (iSCSI or FC).
  • SCBConnection <SCBConnection>The client handle for SCB server.

    It can be created via New-SCBConnection. If the SCBConnection is not specified, a most recently used SCBConnection is utilized by default. The connection can be found via the global variable $Global:DefaultConnection. If multiple SCB servers are connected, you must explicitly specify the SCBConnection parameter.

For example, unmap a volume from two hosts:
PS C:\>Remove-SCBHostVolMapping -VolumeID 6005076801A707416800000000B76 
-HostIDs 22,21 -SCBConnection $client