Dell Storage Center Command Set 7.
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. Copyright © 2014 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents About This Guide............................................................................................................... 5 Revision History..................................................................................................................................................................5 Audience............................................................................................................................................................................
New Name for PowerShell Snapin.............................................................................................................................. 19 Internal Object Type Modifications.............................................................................................................................. 19 Snapins for Versions 5.x and 7.x Script Examples............................................................................................................. 20 Example Using Version 5.
About This Guide This guide provides instructions for installing and using the Dell Storage Center Command Set. Revision History Document Number: 680-037-006 Revision Date Description A September 2014 Initial release Audience Target audiences for this document are Dell storage administrators with knowledge of Windows PowerShell.
1 Getting Started This section provides a brief overview of the Dell Storage Center Command Set snapin, lists requirements for using the command set, and briefly describes features and enhancements that are new with the release. Introduction Dell Storage Center Command Set provides access to cmdlets and scripting objects that interact with a Dell Storage Center via Windows PowerShell interactive shell, scripts, and PowerShell hosting applications.
3. To complete installation, follow the installation wizard instructions.
2 Using the Command Set This section provides instructions for installing and setting up Dell Storage Center Command Set for Windows PowerShell and provides information for getting started with the Command Set.
The $connection variable is used with the -Connection parameter to connect to a Storage Center. For example: Get-SCVolume -Connection $connection Save Connection Information to a -ConnectionName Object Connection information can be saved to a -ConnectionName object using the -Save parameter with the Get-SCConnection command.
A script can now access this file using the following command: $pass = ConvertTo-SecureString (Get-Content C:\password.txt) Using PowerShell Objects Windows PowerShell cmdlet parameters, including those available with the Dell Storage Center Command Set, accept objects as arguments. Objects include standard objects such as string and integer objects, as well as Storage Center specific objects. Store Objects in Variables Objects can be created and stored in variables.
Object Description SCPort Represents a Storage Center controller port. SCReplay Represents a Storage Center Replay. SCReplayProfile Represents a Storage Center Replay profile. SCReplaySchedule Represents a Storage Center Replay schedule. SCReplicationQos Represents a Storage Center replication quality of service (QoS) definition. SCServer Represents a Storage Center server. SCServerFolder Represents a Storage Center server folder. SCStorageCenter Represents a Storage Center.
Command Description Get-NextFreeDriveLetter Queries the Windows Virtual Disk Service for the next available drive letter that could be used to assign as a volume path. Get-SCAlert Retrieves all alerts that were generated on the controller with a specified serial number. Get-SCAsyncReplication Returns asynchronous replications, including those that support Live Volume replications. By default, the Get-SCAsyncReplication cmdlet does not return this type of replication.
Command Description New-SCCmmMigrate Creates a Copy, Mirror, or Migrate operation on Storage Center to migrate all data from one volume to another. New-SCCmmMirror Creates a Copy, Mirror, or Migrate operation on Storage Center to mirror all data from one volume to another. New-SCLiveVolume Creates a new Live Volume. New-SCReplay • • Creates a new Replay on a volume (SCReplayProfile parameter).
Command Description Remove-SCReplayProfile Removes the Replay profile from the Storage Center. Displays an error if the profile is currently applied to any volumes. The -Force parameter removes the Replay profile from assigned volumes and then removes the Replay profile. Attempting to remove a system-created Replay profile returns an error. Remove-SCReplaySchedule Removes a Replay schedule from a Replay profile. Remove-SCReplicationQos Deletes a quality of service (QoS) definition.
Command Description Set-SCStorageProfile Sets the attributes of a Storage Profile. Set-SCUser Sets attributes of user accounts on a Storage Center (Password parameter). Set-SCVolume Sets a new name for a volume. Set-SCVolumeFolder Sets attributes of a volume folder such as name and parent folder. Set-SCVolumeReplayProfile Applies a Replay profile to a volume. Set-Volume Sets or clears flags of a volume on a Windows server. Swap Role-SCLiveVolume Swaps role of a Live Volume.
• If the path to your script includes blank spaces, type an ampersand (&) followed by the path enclosed in quotation marks: &“C:\my scripts\myscript.ps1” • To run a script from the current directory, use .\: .\myscript.ps1 • Include the folder containing your script in your Windows path, then type the name of the script: myscript.ps1 Storage Center Snapin Utility The Storage Center Snapin Utility module provides a library of common functions.
To save information to a csv file: Get-SCVolume -Name MyVolume|Export-Csv -path “C:\volumeInformation\MyVolume.csv” To save information as a txt file: Get-SCVolume -Name MyVolume|Format-List|Out-File -filePath “C:\volumeInformation \MyVolume.txt” Viewing and Printing Command-Line Help The Dell Storage Center Command Set provides help for the commands. You can access this help from the command line. Access help information for each cmdlet in the Command Set Shell Enter the Get-Help command.
A Migrating Scripts from Version 5.x This appendix provides information about migrating from Dell Storage Center Command Set version 5.x to 7.x. Scripts written with version 6.x are compatible with version 7. Syntax Modification Examples At release 6.x, cmdlet syntax was modified to make parameters consistent, increase the ability to pipeline results, and simplify cmdlet syntax. No additional syntax modifications were made in version 7.x.
Example Two: Set-SCVolume Set-SCVolume illustrates differences in cmdlet syntax between versions 5.x and 6.x/7.x. The version 6.x/7.x syntax is cleaner and easier to use than the version 5.x syntax. Set-SCVolume Syntax Version 5.
Snapins for Versions 5.x and 7.x Script Examples Dell Storage Center Command Set 7.x allows you to have snapins for versions 5.x and 7.x loaded at the same time to accommodate cmdlet modifications. The following script examples demonstrate using the Add-PSSnapin cmdlet when migrating from version 5.x to 7.x. • The script examples are written to run in a PowerShell console; you must explicitly load the Storage Center snapins.