About PowerMax cmdlets

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