Using PowerShell for EMC XtremIO


EMC have released XIOS version 4.1.10-33 and XMS version 4.2 recently and with this release they have added PowerShell support. Being a PowerShell guy this is a good thing for automation and maintaining EMC XtremIO. In this post we will cover downloading and installing PowerShell for XtremIO and a few of the available features.


Download the PowerShell Modules for XtremIO from here You will need to have an account with EMC to be able to access the download.

Install the package. The libraries will be installed to C:\Windows\System32\WindowsPowerShell\v1.0\Modules. Now you have the PowerShell modules installed and ready to use.

Next you will need to install the root certificate from your array(s) also, to avoid any verification warnings or issues. Load the XMS splash screen and click on and install the certificate into the local Trusted Root Certification Authorities cert store.


Once you have the root certificate you need to install it into Trusted Root Certificates Authorities. Click run > mmc and press OK. Click File > Add/Remove Snapin and move Certificates to Selected snapin. When the popup appears select Computer Account, click Next.

xms cert 1

Select Computer account and click Next.

xms cert 2

Select Local Computer and click Finish. Click ok and you are ready to import the certificate.

Expand Certificates> Trusted Root Certificates Authorities and click on Certificates. Right click on Certificates and click All Tasks > Import and the wizard will start.

xms cert 3

Click the browse button and find the downloaded root certificate and select it. Click Next.

xms cert 4

Make sure it says Trusted Root Certification Authorities and click Next.

xms cert 6

Click Finish.

xms cert 7

If you have more than one XtremIO you will need to import their root certificates as well, otherwise you are done and ready to start using PowerShell for XtremIO.

Using PowerShell for XtremIO

So now we can start using some of the many cmdlets available to manage XtremIO using PowerShell.

Open a PowerShell session and load the xtremlib using import-module.

PS C:\> Import-Module XtremLib

Now we are ready to start a session to XtremIO. Using New-XtremSession we can connect to our XtremIO device.

PS C:\> New-XtremSession -XmsName –Username <userid> –Password<password>

Note: If you did not install the root certificate this step will fail.

Exiting a XtremSession

When you are done working on you XtremIO cluster or want to manage another cluster you must exit the session. Note when you run this command it will kill all sessions.

PS C:\> Remove-XtremSession

Check XtremIO health

PS C:\> Get-XtremClusters -Properties sys-health-state | ft –autosize


Get a List of Storage Controllers

PS C:\> Get-XtremStorageControllers

Get Details on a Storage Controller

PS C:\> Get-XtremStorageController XIO-X1


List Tags

PS C:\> Get-XtremTags


Get Details on a specific Tag

PS C:\> Get-XtremTag -TagName SPARE -ObjectType Initiator


Get a list of Volumes

PS C:\> Get-XtremVolumes


Retrieve details on a specific Volume

PS C:\> Get-XtremVolume -VolName cvgapesx403-BOOT


Note: When you see details output the left column are the properties and will allow you to fine tune your queries to exactly what you want by adding -Property <list of items comma separated>


We have install PowerShell for XtremIO and have explored a few of the 122 functions available. To learn what other possibilities there are available type Get-XtremHelp.







2 Responses to “Using PowerShell for EMC XtremIO”

  1. vaibhav says:

    I am very new to powershell.
    Perfect instructions.. it worked for me..

    after investing a lot of time on google and other options.. Finally this one worked. 🙂

    Do you have any sample script for XIO Health checks ?


Leave a Reply

Your email address will not be published. Required fields are marked *