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 Only TLS 1.2 protocol is supported. Certificates need to be imported to the Trusted Root Certification Authorities prior to running the Connect-Unisphere command. To disable certificate validation you can use the -IgnoreCertErrors option to Connect-Unisphere. You can also run "[Net.ServicePointManager]::ServerCertificateValidationCallback = { $true }" prior to executing the Connect-Unisphere cmdlet. Please note that this will disable certificate validation for all cmdlets in current PowerShell session including cmdlets from other modules. Supported Unisphere Versions This module requires Unisphere servers running Unisphere 10.0.0 or later. Storage Group Snapshot Support Storage group snapshot management requires PowerMax arrays with microcode version 5978.669.669 or higher. Refer to the PowerMax documentation or contact Dell Support for more information. 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. 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 |