en-US/about_PowerMax_Module.help.txt
|
TOPIC
about_PowerMax_Module SHORT DESCRIPTION Explains how to import and use the PowerMax module. LONG DESCRIPTION The PowerShell module for Dell PowerMax arrays provides cmdlets for management of PowerMax arrays. Cmdlets in this module provide tools for provisioning of hosts, storage groups, volumes, snapshots, and remote replication (RDF). HOW TO USE THE MODULE The module must be imported using the Import-Module command. # Simple option to import the module Import-Module Dell.PowerMax # Import the module using a prefix of PowerMax for each command Import-Module -Prefix PowerMax Dell.PowerMax The use of the prefix will allow for all cmdlets to be called via a prefixed form of the cmdlet, e.g. Get-PowerMaxHost can be used instead of Get-Host. This is useful for cases where there is a name conflict between the cmdlets in different modules. An alternative is to prefix the cmdlet with the module name, e.g. Dell.PowerMax\Get-Host. The PowerMax module communicates with one or more Unisphere servers via HTTPS using the Unisphere REST API. Most cmdlets require that a Unisphere object be used. Use the Connect-Unisphere cmdlet to connect to the target Unisphere server and save the output to a variable, e.g. $unisphere. $unisphere = Connect-Unisphere -HostName <address> <credential> The variable can now be used in subsequent cmdlets, e.g. Get-Volume $unisphere 000123456789 Case Insensitivity This module communicates with the Unisphere server using the Unisphere REST API. This REST API is case insensitive and case preserving. The implication is that the case of the object ID is not checked when selecting the object to operate on. Unisphere does not allow two objects of the same class (e.g. volume, storage group) to have the same name differing by case. Snapshot Policy Support Support for snapshot policy management requires Unisphere servers running Unisphere 9.2.0 or later. The PowerMax arrays must also be running a version of microcode which supports snapshot policies. Refer to the PowerMax documentation or contact Dell Support for more information. Volume ID PowerMax volume IDs are represented as hexadecimal strings, e.g. 001, 010D. PowerShell interprets a number ending in the letter D or d as an integer value. For example 010D will be interpreted as decimal value 10 instead of the hexadecimal 010D (integer 269). When specifying volume IDs, or any string containing numbers and ending with a D or d you must quote the string to prevent PowerShell from interpreting it as a decimal value, e.g. '010D' instead of 010D. SEE ALSO Connect-Unisphere Disconnect-Unisphere |