Install Cisco UCS PowerTool Suite

This chapter consists of the following sections:

Installing or Upgrading UCS PowerTool Modules

You can install the individual PowerShell module of PowerTool using Install-Module Cmdlet from PowerShell. For example, you can install Cisco.UCSManager module from PowerShell gallery and perform operations on UCSM using this module.

Uninstall the PowerShell modules of PowerTool with the older version before installing the new version. To uninstall the PowerTool modules, use the Uninstall-Module Cmdlet. Example:

Uninstall-Module -Name Cisco.UCSManager


Note

  • Prior to the release 2.5(2), the PowerTool modules were posted at cisco.com.

    Release 2.5(2) onwards, the PowerTool modules will be available at: https://www.powershellgallery.com/profiles/Cisco.

  • The Cisco.UCS.DesiredStateConfiguration module is not supported in 3.x release.

Perform the following steps to install the PowerShell modules of PowerTool from PowerShell gallery:

Procedure

Step 1

Launch PowerShell using Run as Administrator on Windows or sudo on Non-Windows.

Step 2

Install the following PowerShell modules of PowerTool from PowerShell Gallery using the Install-Module Cmdlet:

  • Cisco.IMC

  • Cisco.UCSManager

  • Cisco.UCSCentral

See the Microsoft documentation for more information about:

Install-Module -Name Cisco.UCSManager

The PowerTool module packages are available at:

https://www.powershellgallery.com/profiles/Cisco

Uninstalling Cisco UCS PowerTool Suite

Perform the following steps to uninstall the PowerShell modules of PowerTool.

Procedure

Step 1

Launch PowerShell using Run as Administrator on Windows or sudo on Non-Windows.

Step 2

Uninstall the following PowerShell modules of PowerTool using the Uninstall-Module Cmdlet:

  • Cisco.IMC

  • Cisco.UCSManager

  • Cisco.UCSCentral

  • Cisco.UCS.Common

Example: Uninstall-Module Cisco.UCSManager

Note 

You cannot uninstall the dependent modules first. For example: Cisco.UCSManager, Cisco.UCSCentral and Cisco.IMC are dependent on the module Cisco.UCS.Common.

So, you need to uninstall these modules first before uninstalling Cisco.UCS.Common.

See the Microsoft documentation for more information about:

Uninstall-Module

To verify if all the modules have been Uninstalled, use the Get-InstalledModule Cmdlet.