HP 3PAR StoreServ Storage PowerShell Toolkit v1.0 User Guide

Transcription

1 HP 3PAR StoreServ Storage PowerShell Toolkit v1.0 User Guide Abstract This document contains detailed instructions on the HP 3PAR StoreServ Storage PowerShell Toolkit v1.0 installation, features, and PowerShell cmdlets. HP Part Number: Published: June 2015 Edition: 1

2 Copyright 2015 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR and , Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Acknowledgments Microsoft and Windows are trademarks of the Microsoft group of companies.

3 Contents 1 Overview...5 Features of PowerShell Toolkit...5 Product Support Installing HP 3PAR StoreServ Storage PowerShell Toolkit...6 Supported Operating Systems and PowerShell Versions...6 Supported HP 3PAR Storage Platforms...6 Pre-requisites...6 Installation procedure...7 cmdlets help PowerShell cmdlets Quick Reference...8 Connection Management cmdlet...8 Help cmdlet...8 Software version cmdlet...8 CPG Management cmdlets...8 Virtual Volume and Virtual Volume Set Management cmdlets...8 Host and Host Set Management cmdlets...9 Virtual LUN Management cmdlets...9 Physical Copy Management cmdlets...9 Virtual Copy (Snapshot) Management cmdlets...9 Port Management cmdlets...10 Task Management cmdlets PowerShell cmdlets...11 Get cmdlets...11 Get-3parCPG...11 Get-3parVV...11 Get-3parVVSet...12 Get-3parHost...12 Get-3parHostSet...13 Get-3parHostPorts...13 Get-3parVLUN...13 Get-3parFCPorts...14 Get-3parFCPortsToCSV...14 Get-3parVVList...14 Get-3parTask...15 Get-3parCmdList...15 Get-3parVersion...16 New cmdlets...16 New-3parCPG...16 New-3parVV...16 New-3parVVSet...17 New-3parHost...17 New-3parHostSet...18 New-3parVLUN...18 New-3parVVCopy...19 New-3parGroupVVCopy...19 New-3parSnapVolume...20 New-3parGroupSnapVolume...21 New-SANConnection...21 Push cmdlets...22 Push-3parVVCopy...22 Contents 3

4 Push-3parGroupSnapVolume...22 Push-3parSnapVolume...22 Remove cmdlets...23 Remove-3parCPG...23 Remove-3parVVSet...23 Remove-3parVV...23 Remove-3parHostSet...24 Remove-3parHost...24 Remove-3parVLUN...24 Set cmdlets...25 Set-3parVV...25 Set-3parHostPorts...25 Set-3parFCPorts...26 Set-3parHost Support and other resources...28 Contacting HP...28 Related information Contents

5 1 Overview The HP 3PAR PowerShell Toolkit helps administrators to manage HP 3PAR StoreServ Storage in Microsoft Windows environments. Features of PowerShell Toolkit The features of the PowerShell Toolkit are as follows: The PowerShell Toolkit supports cmdlets, which are a wrapper around the native HP 3PAR StoreServ Storage CLI commands. When a cmdlet is run, the following actions take place: A secure connection to the HP 3PAR StoreServ Storage console is established over Secure Shell. The native HP 3PAR StoreServ Storage CLI command and parameters are formed based on the PowerShell cmdlet and parameters. The native HP 3PAR StoreServ Storage CLI command is executed. The output of most of the cmdlets is returned as text. The output of some of the cmdlets is returned as PowerShell objects. This output can be piped to other PowerShell cmdlets for search. Product Support HP 3PAR StoreServ Storage PowerShell Toolkit supports PowerShell v2.0 and later. It provides 36 cmdlets to manage the following operations: Viewing and managing Common Provision Group (CPG) Viewing and managing Virtual Volumes Viewing and managing Virtual Volume Sets Viewing and managing Hosts Viewing and managing Host Sets Viewing and managing Virtual Logical Unit Number (vlun) Viewing and managing Physical copy Viewing and managing Virtual copy (Snapshots) Viewing and managing Ports Viewing and managing Tasks Features of PowerShell Toolkit 5

6 2 Installing HP 3PAR StoreServ Storage PowerShell Toolkit This chapter decribes the HP 3PAR StoreServ Storage PowerShell Toolkit installation procedure, pre-requisites, and supported operating systems. Supported Operating Systems and PowerShell Versions HP 3PAR StoreServ Storage Toolkit works with PowerShell v2.0 and later. You can use this Toolkit in the following environments: PowerShell v2.0 Windows XP SP3 Windows Vista SP1 Windows 7 Windows Server 2003 SP2 Windows Server 2008 R2 PowerShell v3.0 Windows 7 SP1 Windows 8 Windows Server 2008 SP1 Windows Server 2008 R2 SP1 Windows Server 2012 PowerShell v4.0 Windows 7 SP1 Windows 8.1 Windows Server 2008 R2 SP1 Windows Server 2012 Windows Server 2012 R2 Supported HP 3PAR Storage Platforms The supported HP 3PAR Storage platforms are as follows: (including all MUs) (including all MUs) (including all MUs) (including all MUs) Pre-requisites To establish Secure Shell connections, the open source Plink (a command-line interface to the PuTTY back ends) software is required. You can download it from the web. 6 Installing HP 3PAR StoreServ Storage PowerShell Toolkit

7 Installation procedure The HP 3PAR StoreServ Storage PowerShell Toolkit is provided as a zipped package. To complete the installation: 1. Unzip the package and copy the folder HP3PARPSToolkit to one of the following locations: %USERPROFILE%\Documents\WindowsPowerShell\Modules\ Copy to this user specific location to make HP 3PAR StoreServ Storage PowerShell Toolkit v1.0 available for the currently logged in Windows user. %SYSTEMROOT%\system32\WindowsPowerShell\v1.0\Modules\ Copy to this system location to make HP 3PAR StoreServ Storage PowerShell Toolkit v1.0 available for all users. 2. Confirm or Copy the Plink software to this location: c:\plink\plink.exe 3. Open an interactive PowerShell console. 4. Import the toolkit module to the supported Windows host as follows: PS C:\>Import-Module HP3PARPSToolkit The Log file location is: %USERPROFILE%\Documents\WindowsPowerShell\Modules\Logs\ %SYSTEMROOT%\system32\WindowsPowerShell\v1.0\Modules\Logs\ cmdlets help Table 1 (page 7) lists the symbols that are used to depict cmdlet syntax. Table 1 conventions Symbol [ ] < > Meaning Indicates optional items. Indicates a value that you define. Separates mutually exclusive choices. Type one of the choices. 1. To get list of cmdlets offered by HP 3PAR StoreServ Storage PowerShell Toolkit, run this cmdlet: PS C:\> Get-3parCmdList 2. To get cmdlet specific help, run this cmdlet: PS C:\> Get-Help <cmdlet> 3. To get cmdlet specific help using the full option, run this cmdlet: PS C:\> Get-Help <cmdlet> -full Installation procedure 7

8 3 PowerShell cmdlets Quick Reference The HP 3PAR StoreServ Storage PowerShell Toolkit v1.0 provides a host of cmdlets allowing you to administer your HP 3PAR StoreServ Storage. This chapter provides an overview of the cmdlets grouped by functionality. Connection Management cmdlet cmdlet Help cmdlet New-SANConnection Description Builds a SAN connection object. For details, see New-SANConnection (page 21) cmdlet Get-3parCmdList Software version cmdlet Description Gets a list of HP 3PAR PowerShell cmdlets. For details, see Get-3parCmdList (page 15) cmdlet Get-3parVersion CPG Management cmdlets Description Gets HP 3PAR storage system software version information. For details, see Get-3parVersion (page 16) cmdlet New-3parCPG Get-3parCPG Remove-3parCPG Description Creates a new CPG. Displays a list of CPGs. Removes a CPG. For details, see New-3parCPG (page 16) Get-3parCPG (page 11) Remove-3parCPG (page 23) Virtual Volume and Virtual Volume Set Management cmdlets cmdlet New-3parVV Get-3parVV New-3parVVSet Get-3parVVSet Get-3parVVList Set-3parVV Description Creates a virtual volume. Gets a list of virtual volumes per domain and CPG. Creates a new volume set. Gets a list of virtual volume sets defined on the storage system and their members. Gets a list of virtual volumes. Updates a snapshot virtual volume with a new snapshot. For details, see New-3parVV (page 16) Get-3parVV (page 11) New-3parVVSet (page 17) Get-3parVVSet (page 12) Get-3parVVList (page 14) Set-3parVV (page 25) 8 PowerShell cmdlets Quick Reference

9 cmdlet Remove-3parVVSet Remove-3parVV Description Removes a virtual volume set or removes virtual volumes from an existing set. Deletes a virtual volume. For details, see Remove-3parVVSet (page 23) Remove-3parVV (page 23) Host and Host Set Management cmdlets cmdlet New-3parHost Get-3parHost New-3parHostSet Get-3parHostSet Remove-3parHostSet Remove-3parHost Set-3parHost Description Creates a new host. Lists all hosts. Creates a new host set. Gets a list of host set information. Remove a host set or remove hosts from an existing set. Creates a new host. Adds WWN or iscsi name to an existing host. For details, see New-3parHost (page 17) Get-3parHost (page 12) New-3parHostSet (page 18) Get-3parHostSet (page 13) Remove-3parHostSet (page 24) Remove-3parHost (page 24) Set-3parHost (page 26) Virtual LUN Management cmdlets cmdlet New-3parVLUN Get-3parVLUN Remove-3parVLUN Description Creates a new vlun and presents it to a host. Gets a list of LUNs that are exported or presented to hosts. Unpresents virtual volumes. For details, see New-3parVLUN (page 18) Get-3parVLUN (page 13) Remove-3parVLUN (page 24) Physical Copy Management cmdlets cmdlet New-3parVVCopy New-3parGroupVVCopy Push-3parVVCopy Description Creates a full physical copy of a virtual volume or a read/write virtual copy on another virtual volume. Creates consistent group of physical copies of a list of virtual volumes. Promotes a physical copy back to a regular base volume. For details, see New-3parVVCopy (page 19) New-3parGroupVVCopy (page 19) Push-3parVVCopy (page 22) Virtual Copy (Snapshot) Management cmdlets cmdlet New-3parSnapVolume New-3parGroupSnapVolume Description Creates a point in time (snapshot) copy of a virtual volume. Creates consistent group snapshots. For details, see New-3parSnapVolume (page 20) New-3parGroupSnapVolume (page 21) Host and Host Set Management cmdlets 9

10 cmdlet Push-3parGroupSnapVolume Push-3parSnapVolume Port Management cmdlets Description Copies the differences of snapshots back to their base volumes. Copies the differences of a snapshot back to its base volume, allowing you to revert the base volume to an earlier point in time. For details, see Push-3parGroupSnapVolume (page 22) Push-3parSnapVolume (page 22) Get-3parFCPorts Get-3parFCPortsToCSV Set-3parFCPorts Get-3parHostPorts Set-3parHostPorts Task Management cmdlets Query 3PAR to get FC ports. Query 3PAR to get FC ports. Configure 3PAR FC ports. Query 3PAR to get all ports including targets, disks, and RCIP ports. Configure settings of the 3PAR array. Get-3parFCPorts (page 14) Get-3parFCPortsToCSV (page 14) Set-3parFCPorts (page 26) Get-3parHostPorts (page 13) Set-3parHostPorts (page 25) cmdlet Get-3parTask Description Displays tasks information. For details, see Get-3parTask (page 15) 10 PowerShell cmdlets Quick Reference

11 4 PowerShell cmdlets Get cmdlets Get-3parCPG This chapter provides a brief description of the cmdlets grouped by type. Displays a list of CPGs. Get-3parCPG [[-cpgname] <String>] cpgname Lists the CPG details from a list of 3par-CPG. C:\PS>Get-3parCPG Lists the specified CPGs in the system. C:\PS>Get-3parCPG -cpgname "MyCPG" Lists the specified CPG name "MyCPG". PS object on success. You can use this object to search further. For example, C:\PS> Get-3parCPG Select Name,VVs returns: Name ---- FC_cpg1 FC_cpg2 VVols Get-3parVV Gets a list of virtual volumes per domain and CPG. Get-3parVV [[-vvname] <String>] [[-DomainName] <String []>] [[-CPGName] <String []>] vvname DomainName CPGName Lists the parameterized name details. Lists the domain name details. Lists the CPG name details. Get-3parVV -vvname PassThru-Disk Lists virtual volume PassThru-Disk. PS object on success. You can use this object to search further. Get cmdlets 11

12 For example, C:\PS> Get-3parVV select name,cpg returns: Name Test_ISV_ _32_D2 Test_ISV_ _32_D3 Test_ISV_ _32_D4 CPG Test_ISV_cpg2 Test_ISV_cpg2 Test_ISV_cpg2 Get-3parVVSet Gets a list of virtual volume sets defined on the storage system and their members. Get-3parVVSet [[-vvsetname] <String>] [[-vvname] <String>] vvsetname vvname Searches the given name in the list of 3Par vvset and returns if found, else returns not found. Specifies the VV to list from the volume set. C:\PS>Get-3parVVSet -vvsetname "MyVVSet" Lists specific virtual volume set name "MyVVSet". For example, C:\PS> Get-3parVVSet returns: ID Name demoset1 demoset2 Members demovolume1 demovolume2 Get-3parHost Lists all hosts. Get-3parHost [[-hostname] <String>] hostname Specifies the host name to be displayed. C:\PS>Get-3parHost Lists all hosts. C:\PS>Get-3parHost - hostname HV01A Lists host HV01A. PS object on success. You can use this object to search further. 12 PowerShell cmdlets

13 For example, C:\PS>Get-3parHost select Name, ID returns: Name C9E79802 DemoHost1 ID Get-3parHostSet Gets a list of host sets information. Get-3parHostSet [[-hostsetname] <String>] [[-hostname] <String>] hostsetname Lists the details available in 3parHostset with hostsetname. hostname Lists the details available in 3parHostset with hostname. C:\PS>Get-3parHostSet Lists host set information. C:\PS>Get-3parHostSet -hostsetname "MyVVSet" Lists specific host set name "MyVVSet". C:\PS>Get-3parHostSet -hostname "MyHost" Shows the host sets containing host "MyHost". For example, C:\PS>Get-3parHostSet -hostsetname "MyVVSet" Lists specific HostSet name "MyVVSet" Get-3parHostPorts Query 3PAR to get all ports including targets, disks, and RCIP ports. Get-3parHostPorts [-SANConnection <_SANConnection>] C:\PS>Get-3parHostPorts Gets a list of host ports that are available. Get-3parVLUN Gets a list of LUNs that are exported or presented to hosts. Get-3parVLUN [[-vvname] <String>] [[-PresentTo] <String>] vvname Lists the details available in 3par VLUN with the vvname. PresentTo Lists the details available in 3par VLUN with the vvname. Get cmdlets 13

14 C:\PS>Get-3parVLUN Lists exported volumes. C:\PS>Get-3parVLUN -vvname PassThru-Disk Lists the LUN numbers and host sets of LUN PassThru-Disk. PS object on success. You can use this object to search further. For example, C:\PS> Get-3parVLUN select Name, ID returns: Name ---- Test_ISV_ _32_D2 Test_ISV_ _32_D3 ID Get-3parFCPorts Query 3PAR to get FC ports. Get-3parFCPorts C:\PS>Get-3parFCPorts Lists the FC ports available on HP 3PAR array. Get-3parFCPortsToCSV Query 3PAR to get FC ports. Get-3parFCPortsToCSV [[-ResultFile] <String>] ResultFile Redirects the result to a specified file with an address of the file. C:\PS>Get-3parFCPortstoCSV -ResultFile C:\3PAR-FC.CSV Outputs the list of FC Ports and stores the result in a.csv file available at the default location. Get-3parVVList Gets a list of virtual volumes. Get-3parVVList [[-vvname] <String>] [[-Prov] <String>] [[-Type] <String>] [[-SANConnection] <Object>] [<Common>] vvname Specifies the volume name. Volume set name is prefixed with set:. 14 PowerShell cmdlets

15 Prov Type Specifies Prov type (full tpvv tdvv snp cpvv ) name. Specifies Prov type ( base vcopy ) name. C:\PS>Get-3parVVList Lists the virtual volumes. C:\PS>Get-3parVVList -vvname PassThru-Disk Lists the virtual volume PassThru-Disk. C:\PS>Get-3parVVList -Prov tpvv Lists the virtual volume provision type as "tpvv". C:\PS>Get-3parVVList -Type vcopy Lists the snapshot (virtual copy) volumes. Get-3parTask PS object on success. You can use this object to search further. Displays tasks information. Get-3parTask [[-all]] [[-done]] [[-failed]] [[-active]] [[-taskid] <String>] [[-SANConnection] <Object>] [<Common>] taskid Specifies the 3PAR task ID. C:\PS>Get-3parTask all Displays all tasks. You must specify the -all option to see system tasks. C:\PS>Get-3parTask done Displays successfully completed tasks. C:\PS>Get-3parTask failed Displays unsuccessfully completed tasks. C:\PS>Get-3parTask -active Displays currently in progress tasks. C:\PS>Get-3parTask -taskid 4 Displays specified task status (task 4). Get-3parCmdList Gets a list of HP 3PAR PowerShell cmdlets. Get-3parCmdList [<Common>] C:\PS>Get-3parCmdList Lists available HP 3PAR PowerShell cmdlets. Get cmdlets 15

16 PS object on success. You can use this object to search further. Get-3parVersion Gets HP 3PAR storage system software versions. Get-3parVersion [[-number]] [[-build]] [[-SANConnection] <Object>] [<Common>] number build Lists HP 3PAR storage system release version numbers only. Lists HP 3PAR storage system build levels. C:\PS>Get-3parVersion Gets a list of HP 3PAR storage system software versions. C:\PS>Get-3parVersion -number Gets a list of HP 3PAR storage system release version numbers only. C:\PS>Get-3parVersion -build Gets a list of HP 3PAR storage system build levels. PS object on success. You can use this object to search further. New cmdlets New-3parCPG Creates a new CPG. New-3parCPG [[-cpgname] <String>] [[-Size] <String>] [[-RAIDType] <String>] cpgname Size RAID type Assigns a new CPG name. Specifies the CPG size in gigabytes. Assigns RAID type to the CPG. For example, RAID 0, RAID 1, RAID 5, RAID 10(1+0). C:\PS>New-3parCPG -cpgname "MyCPG" -Size 32G -RAIDType r1 Creates a CPG named MyCPG with initial size of 32 GB and RAID configuration is r1 (RAID 1). New-3parVV Creates a virtual volume. New-3parVV [[-vvname] <String>] [[-Size] <String>] [[-CPGName] <String>] [[-vvsetname] <String>] [[-tpvv]] [[-minalloc] <String>] 16 PowerShell cmdlets

17 Size vvname vvsetname vvtype minalloc Specifies the memory size to be allocated. Assigns a new host name. Allocates the newly created VVol to present VVol set name. Specifies the destination vvcopy type. For example, tpvv or tdvv. Specifies the default allocation size in MB. C:\PS>New-3parVV -vvname PassThru-Disk -Size 100g -CPGName HV -vvsetname MyVolumeSet Creates a new volume named PassThru-disk of size 100 GB. The volume is created under the HV CPG group and is contained inside the MyvolumeSet volume set. If MyvolumeSet does not exist, the cmdlet creates a new volume set. C:\PS>New-3parVV -vvname PassThru-Disk1 -Size 100g -CPGName MyCPG -tpvv -minalloc 50G -vvsetname MyVolumeSet Creates a new thin provision volume named PassThru-disk1 of size 100 GB. The volume is created under the MyCPG CPG group and is contained inside the MyvolumeSet volume set. If MyvolumeSet does not exist, the cmdlet creates a new volume set and allocates minimum 50G. New-3parVVSet Creates a new volume set. New-3parVVSet [[-vvsetname] <String>] [[-Domain] <String>] [[-vvname] <String>] vvsetname Domain vvname Assigns HostSet name. Specifies the domain name. Specifies the VV to add to the volume set. C:\PS>New-3parVVSet -vvsetname "MyVolumeSet" Creates a volume set named MyVolumeSet. C:\PS>New-3parVVSet -vvsetname "MYVolumeSet" -Domain MyDomain Creates a volume set named MyVolumeSet in the domain MyDomain. New-3parHost Creates a new host. New-3parHost [[-hostname] <String>] [[-hostset] <String>] [[-Persona] <String>] [[-Address] <String[]>] [[-iscsi]] [[-Domain] <String>] HostName Hostset Assigns a new name to the host you create. Allocates the newly created host to the created Hostset. New cmdlets 17

18 Persona Specifies the persona ID. Persona ID Name Generic Generic ALUA Generic legacy HPUX legacy AIX legacy EGENERA ONTAP legacy address iscsi Address of fiber channel (FC) to which the host is to be allocated. Configures iscsi host controllers on the HP 3PAR array. C:\PS>New-3parHost -hostname HV01A -persona 2 -Address C97B142E Creates a host entry named HV01A with WWN equal to C97B142E. C:\PS>New-3parHost -hostname HV01B -persona 2 -iscsi:$true -Address iqn com.microsoft:dt-391-xp.hq.3par.com Creates a host entry named HV01B with iscsi equal to iqn com.microsoft:dt-391-xp.hq.3par.com. C:\PS>New-3parHost -hostname HV01A -persona 2 -Address C97B142E -hostset demohostset Creates a host entry named HV01A with WWN equal to C97B142E and adds host to hostset demohostset if hostset present, if not it will create hostset and add a host to hostset. New-3parHostSet Creates a new host set. New-3parHostSet [[-hostsetname] <String>] [[-hostname] <String>] [[-Domain] <String>] hostsetname Domain Specifies the host set name. Specifies the domain you want to join. C:\PS>New-3parHostSet -hostsetname HV01C-HostSet Creates an empty host set named "V01C-HostSet". New-3parVLUN Creates a new vlun and presents it to a host. 18 PowerShell cmdlets

19 New-3parVLUN [[-vvname] <String>] [[-PresentTo] <String[]>] [[-LUNnumber] <String>] vvname PresentTo LUNnumber WWN address of the host. Presents the virtual volume to a specified LUN number. Specifies the LUN number of a virtual volume. C:\PS>New-3parVLUN -vvname PassThru-Disk -PresentTo HV01 Exports a virtual volume named PassThru-Disk and presents it to HV01. New-3parVLUN -vvname set:witness_set -PresentTo set:hv01c-set Exports a volume set and presents it to a host set. New-3parVVCopy Creates a full physical copy of a VVol or a read/write virtual copy on another VVol. New-3parVVCopy [[-parentname] <String>] [[-vvcopyname] <String>] [[-online]] [[-CPGName] <String>] [[-snpcpgname] <String>] [[-vvtype] <String>] Name vvcopyname CPGName snpcpgname vvtype Specifies the name of the parent VVol. Specifies the name of the VVol copy name. Specifies the name of CPG. Specifies the name of snapshot CPG. Specifies the type of destination vvcopy. For exampe, tpvv and tdvv. C:\PS>New-3parVVCopy -parentname VV1 -vvcopyname VV2 Creates a copy of the VVol vv. C:\PS>New-3parVVCopy -parentname set:vvset1 -tdvv -snpcpgname cpg2 -CPGName cpg1 Creates a set of copies from a source volume set. Each destination volume will be a thin duplicated volume with a name based on the source volume. C:\PS>New-3parVVCopy -parentname vv1 -online -snpcpgname cpg2 -CPGName cpg1 -vvcopyname vv2 Creates an online copy of vv1 that is named vv2 which is fully-provisioned, using cpg1 as its user space and cpg2 as its snapshot space. New-3parGroupVVCopy Creates consistent group physical copies of a list of virtual volumes. New cmdlets 19

20 New-3parGroupVVCopy [[-names] <String>] Name Specifies the name of the parent VVol and destination VVol in following format: names parentvolume1:destinationvolume1 names parentvolume1:destinationvolume1, parentvolume2:destinationvolume2 C:\PS>New-3parGroupVVCopy -names parentvv1:destvvcopy1 Creates consistent copies of the parentvv1 to destvvcopy1. C:\PS>New-3parGroupVVCopy -names parentvv1:destvvcopy1, parentvv2:destvvcopy2 Creates consistent copies of the parentvv1 to destvvcopy1 and parentvv2 to destvvcopy2. New-3parSnapVolume Creates a point in time snapshot copy of a virtual volume. New-3parSnapVolume [[-svname] <String>] [[-vvname] <String>] [[-exp] <String>] [[-retain] <String>] [[-ro]] [[-vvsetname] <String>] svname vvname exp Specifies the snapshot name. Specifies the parent volume name or volume set name. Specifies the relative time from the current time, when a volume expires <time>[d D h H]. <time> is a positive integer value. Time can be optionally specified in days or hours. You can use either d or D for day and h or H for hours, following the entered time value. retain Specifies the relative time from the current time up to when a volume is retained <time>[d D h H]. <time> is a positive integer value. Time can be optionally specified in days or hours. You can use either d or D for day and h or H for hours, following the entered time value. vvsetname Specifies the virtual volume set names as set: vvset name. For example, set:vvcopies C:\PS>New-3parSnapVolume -ro -svname svr0_vv0 -vvname vv0 Creates a read-only snapshot volume "svro_vv0" from volume "vv0". C:\PS>New-3parSnapVolume -svname svrw_vv0 -vvname svro_vv0 Creates a snapshot volume "svrw_vv0" from the snapshot "svro_vv0". C:\PS>New-3parSnapVolume -ro svname svro-@vvname@ -vvsetname set:vvcopies Creates a snapshot volume for each member of the VVol set vvcopies. Each snapshot is named svro-<name of parentvolume>. 20 PowerShell cmdlets

21 New-3parGroupSnapVolume Creates consistent group snapshots. New-3parGroupSnapVolume [[-vvnames] <String>] [[-option] <String>] [[-exp] <String>] [[-retain] <String>] vvname option Specifies the existing VVol with comma (,) separation. For example, vv1, vv2, vv3. Specifies read only (ro)/read-write (rw) option. C:\PS>New-3parGroupSnapVolume -option ro -vvnames VV1, VV2 Creates a snapshot group as read only with the VVol members as VVol1 and VVol2. C:\PS>New-3parGroupSnapVolume -vvnames VV1, VV2 Creates a snapshot group as read/write (default) with the VVol members as VVol1 and VVol2. New-SANConnection Builds a SAN connection object. New-SANConnection [-SANUserName] <String> [[-SANPassword] <String>] [-SANIPAddress] <String> [[-SSHDir] <String>] [<Common>] UserName Password SANIPAddress SSHDir Specifies the SAN administrator username. For example, 3paradm. Specifies the SAN administrator password. Specifies the SAN IP address. Specifies the absolute path of Plink.exe. The default path is C:\plink. C:\PS>New-SANConnection -SANUserName Administrator -SANPassword mypassword -SANIPAddress SSHDir "C:\plink" Creates a SAN connection object with the specified SAN IP address. SAN connection object on success. For example, PS C:\> New-SANConnection returns: AdminName Password IPAddress SSHDir paradm System.Security.SecureString C:\plink New cmdlets 21

22 Push cmdlets Push-3parVVCopy Promotes a physical copy back to a regular base volume. Push-3parVVCopy [[-physicalcopyname] <String>] physicalcopyname Specifies the name of the physical copy to be promoted. C:\PS>Push-3parVVCopy -physicalcopyname volume1 Promotes virtual volume "volume1" to a base volume. Push-3parGroupSnapVolume Copies the differences of snapshots back to their base volumes. Push-3parGroupSnapVolume [[-VVNames] <String>] VVNames Specifies virtual copy name of the snapshot C:\PS>Push-3parGroupSnapVolume -VVNames vv1,vv2 Copies the snapshot groups back to their specified base volumes. C:\PS>Push-3parGroupSnapVolume -VVNames vv1:tvv1,vv2:tvv2 Copies the snapshot groups back to their specified base volumes. Push-3parSnapVolume Copies the differences of a snapshot back to its base volume, allowing you to revert the base volume to an earlier point in time. Push-3parSnapVolume [[-name] <String>] [[-target] <String>] name target Specifies the name of the virtual copy volume or set of virtual copy volumes to be promoted. Copies the differences of the virtual copy to the specified RW parent in the same virtual volume family tree. C:\PS>Push-3parSnapVolume -name vv1 Copies the differences of a snapshot back to its base volume vv1 C:\PS>Push-3parSnapVolume -target vv23 -name vv1 Copies the differences of a snapshot back to its target base volume named vv23 22 PowerShell cmdlets

23 Remove cmdlets Remove-3parCPG Removes a CPG Remove-3parCPG [[-cpgname] <String>] [[-force]] cpgname force Specifies the CPG name. Indicates that the cmdlet is forced. For example, C:\PS>Remove-3parCPG -cpgname "MyCPG -force Removes a CPG "MyCPG". Remove-3parVVSet Removes a VVol set or, VVols from an existing set. Remove-3parVVSet [-vvsetname] <String> [[-vvname] <String>] [[-force]] vvsetname vvname force Removes a specified VVol set. Removes a specified VVol. Specifies that the command is forced. C:\PS>Remove-3parVVSet -vvsetname "MyVVSet" -force Remove the VVol set "MyVVSet". C:\PS>Remove-3parVVSet -vvsetname "MyVVSet" -vvname "MyVV" -force Remove the single VVol "MyVV" from a VVol set "MyVVSet". Remove-3parVV Deletes a volume. Remove-3parVV [[-vvname] <String>] [[-whatif]][[-force]] vvname whatif force Deletes the specified virtual volume. Dry-run of the deleted operation on VVol. Specifies that the command is forced. C:\PS>Remove-3parVV -vvname PassThru-Disk -whatif Dry-run of deleted operation on the vvolume named PassThru-Disk. Remove cmdlets 23

24 C:\PS>Remove-3parVV -vvname PassThru-Disk -force Forcibly deletes vvolume named PassThru-Disk. Remove-3parHostSet Removes a host set or hosts from an existing set. Remove-3parHostSet [-hostsetname] <String> [[-hostname] <String>] [[-SANConnection] <Object>]<Common>] [[-force]] hostsetname hostname force Removes the specific host set passed through this parameter. Removes the specific host passed through this parameter. Specifies that the command is forced. C:\PS>Remove-3parHostSet -hostsetname "MyHostSet" -force Remove the hostset MyHostSet". C:\PS>Remove-3parHostSet -hostsetname "MyHostSet" -hostname "MyHost" -force Remove the single host "MyHost" from the hostset "MyHostSet". Remove-3parHost Removes a new host. Remove-3parHost [[-HostName] <String>] [[-iscsi]] [[-Address] <String[]>] HostName iscsi Address WWN address of the host. iscsi address of the host. Address of the FC from which you want to remove the host. C:\PS>Remove-3parHost -hostname HV01A Removes the host named HV01A. C:\PS>Remove-3parHost -hostname HV01A -address C97B142E Removes the WWN address of the host named HV01A. Remove-3parVLUN Unpresents virtual volumes. Remove-3parVLUN [[-vvname] <String>] [[-PresentTo] <String>] [[-whatif]] [[-force]] 24 PowerShell cmdlets

25 vvname PresentTo whatif Unpresents the specified vvname. Unpresents the virtual volume disk to a host. Dry-run of the deleted operation on VVol. C:\PS>Remove-3parVLUN -vvname PassThru-Disk -force Unpresents the virtual volume PassThru-Disk from all hosts. C:\PS>Remove-3parVLUN -vvname PassThru-Disk -PresentTo INF01 -force Unpresents the virtual volume PassThru-Disk only to host INF01. All other presentations of PassThru-Disk remain intact. Set cmdlets Set-3parVV Updates a snapshot virtual volume with a new snapshot. Set-3parVV [[-name] <String>] [[-ro]] [[-force]] name ro force Specifies names of either the snapshot or virtual volumes or virtual volume sets that you want to update. Specifies that if the specified virtual volume (<VV_name>) is a read/write snapshot, the snapshot s read-only parent volume is also updated with a new snapshot if the parent volume is not a member of a virtual volume set. Specifies cmdlet is forced. C:\PS>Set-3parVV -name volume1 C:\PS>Set-3parVV -name volume1, volume2 C:\PS>Set-3parVV -name set:vvset1 C:\PS>Set-3parVV -name set:vvset1,set:vvset2 Set-3parHostPorts Configure settings of the HP 3PAR array. Snapshot update of VVol "volume1" Snapshot update of VVol's "volume1" and "volume2" Snapshot update of VVolSet "vvset1" Snapshot update of VVolSet's "vvset1" and "vvset2" Set-3parHostPorts [-FCConfigFile <String>] [-iscsiconfigfile <String>] [-LDConfigFile <String>] [-SANConnection <_SANConnection>] [[-Demo]] FCConfigFile Configures FC host controllers on the HP 3PAR array. Set cmdlets 25

26 iscsiconfigfile LDCConfigFile Configures iscsi host controllers on the HP 3PAR array. Configures logical disks on the HP 3PAR array. C:\PS>Set-3parHostPorts -FCConfigFile FC-Nodes.CSV Configures FC host controllers on the HP 3PAR array. Set-3parHostPorts -iscsiconfigfile iscsi-nodes.csv Configures iscsi host controllers on the HP 3PAR array. Set-3parHostPorts -LDConfigFile LogicalDisks.CSV Configures logical disks on the HP 3PAR array. Set-3parHostPorts -FCConfigFile FC-Nodes.CSV -iscsiconfigfile iscsi-nodes.csv -LDConfigFile LogicalDisks.CSV Configures FC, iscsi host controllers, and logical disks on the HP 3PAR array. Set-3parFCPorts Configures 3PAR FC ports. Set-3parFCPorts [[-Ports] <String[]>] [-DirectConnect] Ports DirectConnect Assigns a port address for the communication of the WWNs. FC connected to a host. C:\PS>Set-3parFCPorts -Ports 1:2:1 Configures 3PAR port 1:2:1 as FC connected to a fabric. C:\PS>Set-3parFCPorts -Ports 1:2:1 DirectConnect Configures 3PAR port 1:2:1 as FC connected to a host (no SAN fabric). C:\PS>Set-3parFCPorts -Ports 1:2:1,1:2:2 Configures 3PAR ports 1:2:1 and 1:2:2 as FC connected to a fabric. Set-3parHost Adds WWN or iscsi name to an existing host. Set-3parHost [[-hostname] <String>] [[-Address] <String[]>] [[-iscsi]] [[-SANConnection] <Object>] [<Common>] hostname Address iscsi Specifies the name of an existing host. Specifies the list of WWNs for the new host. If present, the iscsi address instead of WWN address. 26 PowerShell cmdlets

27 C:\PS>Set-3parHost -hostname HV01A -Address C97B142E, C97B142F Adds WWN C97B142E, C97B142F to host HV01A. C:\PS>Set-3parHost -hostname HV01B -iscsi:$true -Address iqn com.microsoft:dt-391-xp.hq.3par.com Adds iscsi iqn com.microsoft:dt-391-xp.hq.3par.com to host HV01B. Set cmdlets 27

28 5 Support and other resources Contacting HP HP technical support For world wide technical support information, see the HP support website: Before contacting HP, collect the following information: Product model names and numbers Technical support registration number (if applicable) Product serial numbers Error messages Log files %USERPROFILE%\Documents\WindowsPowerShell\Modules\Logs\ DebugLog-<timestamp>.txt Operating system type and revision level Detailed questions Subscription service HP recommends that you register your product at the Subscriber's choice for Business website: After registering, you will receive notification of product enhancements, new driver versions, firmware updates, and other product resources. Related information Documents To find related documents, browse to the Manuals page of the HP Business Support Center web site: 28 Support and other resources