About Cisco UCS PowerTool Suite

Cisco UCS PowerTool suite is a set of PowerShell modules that helps automate all aspects of Cisco UCS Manager, Cisco UCS Central, and Cisco IMC. It also helps automate server, network, storage, and hypervisor management. Cisco UCS PowerTool suite enables easy integration with existing IT management processes and tools. The PowerTool cmdlets work on the Cisco UCS Management Information Tree (MIT). The cmdlets can be used to execute read, create, modify, and delete operations on all the UCS Managed Objects (MOs) in the MIT.


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.


Revision History

The following table shows the revision history:

Revision

Release

Date

Description

Q0

3.0.5

April 2024

Updated the following sections for Cisco UCS PowerTool Suite, Release 3.0.5:

New Features for Release 3.0(5)

P0

3.0.4.2

May 2023

Updated the following sections for Cisco UCS PowerTool Suite, Release 3.0.4.2:

Resolved Caveats

N0

3.0(4)

March 2023

Updated the following sections for Cisco UCS PowerTool Suite, Release 3.0(4):

M0

3.0(3)

November 2022

Updated the following sections for Cisco UCS PowerTool Suite, Release 3.0(3):

L0

3.0(2)

September 2021

Updated the following sections for Cisco UCS PowerTool Suite, Release 3.0(2):

K0

3.0(1)

November 2020

Updated the following sections for Cisco UCS PowerTool Suite, Release 3.0(1):

J0

3.0

July 2020

Updated the following section for Cisco UCS PowerTool Suite, Release 3.0(0):

I0

2.5(3)

January 2020

Updated the following section for Cisco UCS PowerTool Suite, Release 2.5:

H0

2.5(2)

November 2019

Updated the following section for Cisco UCS PowerTool Suite, Release 2.5:

E0

2.3(1)

November 2017

Updated the following section for Cisco UCS PowerTool Suite, Release 2.3:

D0

2.2(1)

February 2017

Updated the following section for Cisco UCS PowerTool Suite, Release 2.2:

C0

2.1(1)

October 2016

Updated the following section for Cisco UCS PowerTool Suite, Release 2.0(2):

B0 2.0(2) June 2016

Updated the following section for Cisco UCS PowerTool Suite, Release 2.0(2):

A0 2.0(1) March 2016 Published release notes for Cisco UCS PowerTool Suite, Release 2.0(1)

System Requirements

Before installing Cisco UCS PowerTool suite, ensure that the system meets the following requirements:

  • Windows PowerShell 5.1 or PowerShell 6.x and above

  • .NET Framework 4.7.1 or above or .NET Core 2.0 and above

Cisco UCS Manager

Cisco UCS Manager PowerTool is compatible with the following Cisco UCS Manager releases:

  • Release 4.2

  • Release 4.1

  • Release 4.0

  • Release 3.2

  • Release 3.1

  • Release 3.0

  • Release 2.5

  • Release 2.2

  • Release 2.1

  • Release 2.0

Cisco UCS C-Series Servers

Cisco IMC PowerTool is compatible with the following Cisco IMC releases:

  • Release 4.2

  • Release 4.1

  • Release 4.0

  • Release 3.1

  • Release 3.0

  • Release 2.0 and higher

  • Release 1.5 and higher

Cisco UCS E-Series Servers

Cisco IMC PowerTool is compatible with the following Cisco UCS E-Series releases:

  • Release 2.2(1) and later for the E-Series servers

Cisco UCS Central

Cisco UCS Central PowerTool is compatible with the following Cisco UCS Central releases:

  • Release 2.0

  • Release 1.5

  • Release 1.4

  • Release 1.3

  • Release 1.2

Installation Requirements


Important


  • It is recommended to uninstall the modules with lower version before upgrading to higher version.

  • Close the instances of PowerShell running with the PowerTool module loaded.


New and Changed Features

New Features for Release 3.0(5)

This section briefly describes the new features introduced in the Cisco UCS PowerTool suite, Release 3.0(5).

Key Features in Release 3.0(5)

  • Support for the new features in Cisco UCS Manager Release 4.3(3a)

  • Support for the new features in Cisco IMC Release 4.3(3.240022)

  • Support for the new features in Cisco UCS Central Release 2.0(1u)

New Cmdlets for Release 3.0(5)

Cisco UCS Manager Release 4.3(3a)

Table 1. Cisco UCS Manager Release 4.3(3a)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

computeModular

ChassisFanPolicy

UcsComputeModular

ChassisFanPolicy

x

x

computePower

ExtendedPolicy

UcsComputePower

ExtendedPolicy

x

x

computePower

SavePolicy

UcsComputePower

SavePolicy

x

x

Cisco IMC Release 4.3(3.240022)

Table 2. Cisco IMC Release 4.3(3.240022)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

adaptorEth

SRIOVProfile

ImcAdaptorEth

SRIOVProfile

x

x

biosVfAdaptive

RefreshMgmtLevel

ImcBiosVfAdaptive

RefreshMgmtLevel

x

x

biosVfDma

CtrlOptIn

ImcBiosVfDma

CtrlOptIn

x

x

biosVf

EnableRMT

ImcBiosVf

EnableRMT

x

x

biosVf

EnableTdx

ImcBiosVf

EnableTdx

x

x

biosVfEnable

TdxSeamldr

ImcBiosVfEnable

TdxSeamldr

x

x

biosVfError

CheckScrub

ImcBiosVfError

CheckScrub

x

x

biosVfIOAT

ConfigCpm

ImcBiosVfIOAT

ConfigCpm

x

x

biosVfM

miohBase

ImcBiosVfM

miohBase

x

x

biosVfM

miohSize

ImcBiosVfM

miohSize

x

x

biosVfOptimized

PowerMode

ImcBiosVfOptimized

PowerMode

x

x

biosVfPchPcie

PllSsc

ImcBiosVfPch

PciePllSsc

x

x

biosVfPrmrrSize

ImcBiosVfPch

PciePllSsc

x

x

biosVfSHA384

PCRBank

ImcBiosVfSHA384

PCRBank

x

x

biosVfX2Apic

OptOut

ImcBiosVfX2Apic

OptOut

x

x

biosf2Password

ImcBiosf2

Password

x

x

niosInstall

ImcNiosInstall

x

x

nvmeHybrid

SlotConfig

ImcNvmeHybrid

SlotConfig

x

pciAdapter

PortStatus

ImcPciAdapter

PortStatus

x

pciAdapter

Temperature

ImcPciAdapter

Temperature

x

slotConfig

ImcSlot

Config

x

x

Cisco UCS Central Release 2.0(1u)

Table 3. Cisco UCS Central Release 2.0(1u)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

computeModular

ChassisFanPolicy

UcsCentralModular

ChassisFanPolicy

x

x

x

x

computePower

ExtendedPolicy

UcsCentralComputePower

ExtendedPolicy

x

x

x

x

computePower

SavePolicy

UcsCentralCompute

PowerSavePolicy

x

x

x

x

policyModular

ChassisFanOp

UcsCentralPolicy

ModularChassisFanOp

x

x

policyPower

ExtendedOp

UcsCentralPolicy

PowerExtendedOp

x

x

policyPower

SaveOp

UcsCentralPolicy

PowerSaveOp

x

x

New Features for Release 3.0(4)

This section briefly describes the new features introduced in the Cisco UCS PowerTool suite, Release 3.0(4).

Key Features in Release 3.0(4)

  • Support for the new features in Cisco IMC Release 4.2(3b)

New Cmdlets for Release 3.0(4)

Cisco IMC Release 4.2(3b)

Table 4. Cisco IMC Release 4.2(3b)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

biosVfTpmSupport

ImcBiosVfTpmSupport

x

x

New Features for Release 3.0(3)

This section briefly describes the new features introduced in the Cisco UCS PowerTool suite, Release 3.0(3).

Key Features in Release 3.0(3)

  • Support for the new features in Cisco UCS Manager Release 4.2(2a)

  • Support for the new features in Cisco IMC Release 4.2(2a)

New Cmdlets for Release 3.0(3)

Cisco UCS Manager Release 4.2(2a)

Table 5. Cisco UCS Release 4.2(2a)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Reset

adaptorPTP

UcsAdaptorPTP

x

x

equipmentBios

PasswordReset

UcsEquipment

BiosPassword

x

Table 6. Cisco UCS Release 4.2(1a)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

biosVfC1

AutoDemotion

ImcBiosVfC1

AutoDemotion

x

x

biosVfC1

AutoUnDemotion

ImcBiosVfC1

AutoUnDemotion

x

x

biosVfCpu

PaLimit

ImcBiosVfCpu

PaLimit

x

x

biosVfCpuPerf

Enhancement

ImcBiosVfCpuPerf

Enhancement

x

x

biosVfLLCAlloc

ImcBiosVfLLCAlloc

x

x

biosVfPcieSlots

CdnEnable

ImcBiosVfPcieSlots

CdnEnable

x

x

biosVfSHA1PCRBank

ImcBiosVf

SHA1PCRBank

x

x

biosVfSHA

256PCRBank

ImcBiosVfSHA

256PCRBank

x

x

biosVfTpm

PpiRequired

ImcBiosVfTpm

PpiRequired

x

x

biosVfUPI

LinkEnablement

ImcBiosVfUPI

LinkEnablement

x

x

biosVfUPI

PowerManagement

ImcBiosVfUPI

PowerManagement

x

x

biosVf

VirtualNuma

ImcBiosVf

VirtualNuma

x

x

biosVfXPT

RemotePrefetch

ImcBiosVfXPT

RemotePrefetch

x

x

commTlsConfig

ImcCommTlsConfig

x

x

deleteRsyslog

CACertificate

ImcDeleteRsyslog

CACertificate

x

x

deleteSecure

BootCertificate

ImcDeleteSecure

BootCertificate

x

x

enableSecuredRsyslog

ImcEnable

SecuredRsyslog

x

x

pciAdapter

FruInventory

ImcPciAdapter

FruInventory

x

pciAdapter

FruInventoryInfo

ImcPciAdapter

FruInventoryInfo

x

secureBootCA

CertificateInfo

ImcSecureBootCA

CertificateInfo

x

secureBoot

CertificateManagement

ImcSecureBoot

CertificateManagement

x

uploadRsyslog

CACertificate

ImcUploadRsyslog

CACertificate

x

x

uploadSecure

BootCertificate

ImcUploadSecure

BootCertificate

x

x

New Features for Release 3.0(2)

This section briefly describes the new features introduced in the Cisco UCS PowerTool suite, Release 3.0(2).

For detailed information about the features listed, see the documents listed in the Related Documentation section.

Key Features in Release 3.0(2)

  • Support for the new features in Cisco UCS Manager Release 4.2(1e)

  • Support for the new features in Cisco IMC Release 4.2(1a)

  • Support for the new features in Cisco UCS Central Release 2.0(1o)

New Cmdlets for Release 3.0(2)

Cisco UCS Manager Release 4.2(1e)

Table 7. Cisco UCS Release 4.2(1e)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

biosVfPanicAnd

HighWatermark

UcsBiosVfPanicAnd

HighWatermark

computePersonality

UcsComputePersonality

x

computePower

SavePolicy

UcsComputePower

SavePolicy

x

x

equipmentAuto

ConfigMode

UcsEquipment

AutoConfigMode

x

equipmentFanAggressive

CoolingCap

UcsEquipmentFan

AggressiveCoolingCap

equipmentPersonality

UcsEquipmentPersonality

x

equipmentSpdm

CertificateCap

UcsEquipmentSpdm

CertificateCap

x

fcpoolOui

UcsFcpoolOui

x

x

x

fcpoolOuis

UcsFcpoolOuis

x

fcpoolOuisFsm

UcsFcpoolOuisFsm

fcpoolOuisFsmStage

UcsFcpoolOuisFsmStage

fcpoolOuisFsmTask

UcsFcpoolOuisFsmTask

firmwareSecureFPGA

UcsFirmwareSecureFPGA

x

mgmtSpdmCertificate

UcsMgmtSpdmCertificate

x

x

x

x

mgmtSpdmCertificate

Data

UcsMgmtSpdm

CertificateData

x

mgmtSpdmCertificate

Inventory

UcsMgmtSpdm

CertificateInventory

x

mgmtSpdmCertificate

Policy

UcsMgmtSpdm

CertificatePolicy

x

x

x

x

mgmtSwPersonalities

UcsMgmtSwPersonalities

x

mgmtSwPersonalities

Inventory

UcsMgmtSw

PersonalitiesInventory

x

mgmtSwPersonality

UcsMgmtSwPersonality

x

pfcWatchDog

UcsPfcWatchDog

x

x

x

x

pfcWatchDogFsm

UcsPfcWatchDogFsm

x

pfcWatchDogFsmStage

UcsPfcWatchDogFsmStage

x

pfcWatchDogFsmTask

UcsPfcWatchDogFsmTask

x

Cisco IMC Release 4.2(1a)

Table 8. Cisco IMC Release 4.2(1a)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

aaaTacacsPlus

ImcAaaTacacsPlus

x

x

aaaTacacsPlusServer

ImcAaaTacacsPlusServer

x

x

aaaUserAuthPrecedence

ImcAaaUserAuthPrecedence

x

x

biosVfAdvancedMemTest

ImcBiosVfAdvancedMemTest

x

x

biosVfBurstAnd

PostponedRefresh

ImcBiosVfBurstAnd

PostponedRefresh

x

x

biosVfCbsCmnApbdis

ImcBiosVfCbsCmnApbdis

x

x

biosVfCbsCmnCpuSmee

ImcBiosVfCbsCmnCpuSmee

x

x

biosVfCbsCmnCpu

StreamingStoresCtrl

ImcBiosVfCbsCmnCpu

StreamingStoresCtrl

x

x

biosVfCbsCmn

EfficiencyModeEn

ImcBiosVfCbsCmn

EfficiencyModeEn

x

x

biosVfCbsCmn

FixedSocPstate

ImcBiosVfCbsCmnFixedSocPstate

x

x

biosVfCbsCmn

GnbSMUCPPC

ImcBiosVfCbsCmnGnbSMUCPPC

x

x

biosVfCbsCmn

GnbSMUDfCstates

imcBiosVfCbsCmnGnb

SMUDfCstates

x

x

biosVfCbsCpuCcdCtrlSsp

ImcBiosVfCbsCpuCcdCtrlSsp

x

x

biosVfCbsCpuCoreCtrl

ImcBiosVfCbsCpuCoreCtrl

x

x

biosVfCbsCpuSmtCtrl

ImcBiosVfCbsCpuSmtCtrl

x

x

biosVfCbsDbgCpu

SnpMemCover

ImcBiosVfCbsDbgCpu

SnpMemCover

x

x

biosVfCbsDbgCpu

SnpMemSizeCover

ImcBiosVfCbsDbgCpu

SnpMemSizeCover

x

x

biosVfCbsDfCmn

AcpiSratL3Numa

ImcBiosVfCbsDfCmn

AcpiSratL3Numa

x

x

biosVfCbsDfCmnDramNps

ImcBiosVfCbsDfCmnDramNps

x

x

biosVfCbsSevSnpSupport

ImcBiosVfCbsSevSnpSupport

x

x

biosVfCiscoXgmiMaxSpeed

ImcBiosVfCiscoXgmiMaxSpeed

x

x

biosVfDramSw

ThermalThrottling

imcBiosVfDramSw

ThermalThrottling

x

x

biosVfEPPEnable

lmcBiosVfEPPEnable

x

x

biosVfEadrSupport

ImcBiosVfEadrSupport

x

biosVfEdpcEn

ImcBiosVfEdpcEn

x

x

biosVfEnableMktme

ImcBiosVfEnableMktme

x

x

biosVfEnableTme

ImcBiosVfEnableTme

x

x

biosVfEpochUpdate

ImcBiosVfEpochUpdate

x

x

biosVfIPV4HTTP

ImcBiosVfIPV4HTTP

x

x

biosVfIPV6HTTP

ImcBiosVfIPV6HTTP

x

x

biosVfIntelDynamic

SpeedSelect

ImcBiosVfIntelDynamicSpeedSelect

x

x

biosVfMemory

BandwidthBoost

ImcBiosVfMemoryBandwidthBoost

x

x

biosVfMemoryRefreshRate

ImcBiosVfMemoryRefreshRate

x

x

biosVfMemory

ThermalThrottling

ImcBiosVfMemory

ThermalThrottling

x

x

biosVfOperationMode

ImcBiosVfOperationMode

x

x

biosVfPanicHighWatermark

ImcBiosVfPanic

HighWatermark

x

x

biosVfPartialCache

LineSparing

ImcBiosVfPartial

CacheLineSparing

x

x

biosVfPostPackageRepair

ImcBiosVfPostPackageRepair

x

x

biosVfSEV

ImcBiosVfSEV

x

x

biosVfSgx

ImcBiosVfSgx

x

x

biosVfSgxEpoch

ImcBiosVfSgxEpoch

x

x

biosVfSgxLePubKeyHash

ImcBiosVfSgxLePubKeyHash

x

x

biosVfTSME

ImcBiosVfTSME

x

x

biosVfUmaBasedClustering

ImcBiosVfUmaBasedClustering

x

x

biosVfVolMemoryMode

ImcBiosVfVolMemoryMode

x

x

endPoint

ImcEndPoint

x

endPointCertificateChain

ImcEndPointCertificateChain

x

endPointRootCACertificate

ImcEndPointRootCACertificate

x

endPointRootCA

CertificateInfo

ImcEndPointRootCA

CertificateInfo

x

x

lsbootEmbeddedStorage

ImclsbootEmbeddedStorage

x

x

lsbootHttp

ImclsbootHttp

x

x

mctpCertificateManagement

ImcMctpCertificateManagement

x

x

rackUnitPersonality

ImcRackUnitPersonality

x

x

storageFlexMMC

ImcStorageFlexMMC

x

x

storageFlexMMC

DownloadFile

ImcStorageFlexMMCDownloadFile

x

x

storageFlexMMCFile

ImcStorageFlexMMCFile

x

x

uploadEndPointRoot

CACertificate

ImcUploadEndPoint

RootCACertificate

x

x

Cisco UCSC Release 2.0(1o)

Table 9. Cisco UCSC Release 2.0(1o)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

adaptorEth

GENEVEProfile

UcsCentralAdaptor

EthGENEVEProfile

x

x

New Features for Release 3.0(1)

This section briefly describes the new features introduced in the Cisco UCS PowerTool suite, Release 3.0(1).

For detailed information about the features listed, see the documents listed in the Related Documentation section.

Key Features in Release 3.0(1)

  • Support for the new features in Cisco IMC Release 4.1(2a)

  • Support for the new features in Cisco UCS Manager Release 4.1(2a)

  • Support for the new features in Cisco UCS Central Release 2.0(1k)

New Cmdlets for Release 3.0(1)

Cisco UCS Manager Release 4.1(2a)

Table 10. Cisco UCS Release 4.1(2a)

Managed Object (MO)

PowerShell Noun

Get

Set

adaptorAzureQosProfile

UcsAdaptorAzureQosProfile

x

x

adaptorEthGENEVEProfile

UcsAdaptorEthGENEVEProfile

x

x

computeFanPolicy

UcsComputeFanPolicy

x

x

processorCacheMemStats

UCSProcessorCacheMemStats

x

processorExecStats

UCSProcessorExecStats

x

processorIOStats

UCSProcessorIOStats

x

processorMiscStats

UCSProcessorMiscStats

x

processorPCIBusStats

UCSProcessorPCIBusStats

x

processorPMUStats

UCSProcessorPMUStats

x

processorSecurityStats

UcsProcessorSecurityStats

x

Cisco IMC Release 4.1(2a)

Table 11. Cisco IMC Release 4.1(2a)

Managed Object (MO)

PowerShell Noun

Get

Set

aaaUserSSHKey

ImcAaaUserSSHKey

x

x

biosVfCRQos

lmcBiosVfCRQos

x

x

biosVfConfigTDPLevel

ImcBiosVfConfigTDPLevel

x

x

biosVfCrfastgoConfig

ImcBiosVfCrfastgoConfig

x

x

biosVfEnableClockSpreadSpec

ImcBiosVfEnableClockSpreadSpec

x

x

biosVfIPV4PXE

ImcBiosVfIPV4PXE

x

x

biosVfMemorySizeLimit

ImcBiosVfMemorySizeLimit

x

x

biosVfNetworkStack

ImcBiosVfNetworkStack

x

x

biosVfNvmdimmPerformConfig

ImcBiosVfNvmdimmPerformConfig

x

x

biosVfPCIeRASSupport

lmcBiosVfPCIeRASSupport

x

x

biosVfPartialMirrorModeConfig

ImcBiosVfPartialMirrorModeConfig

x

x

biosVfPartialMirrorPercent

ImcBiosVfPartialMirrorPercent

x

x

biosVfPartialMirrorValue1

lmcBiosVfPartialMirrorValue1

x

x

biosVfPartialMirrorValue2

lmcBiosVfPartialMirrorValue2

x

x

biosVfPartialMirrorValue3

lmcBiosVfPartialMirrorValue3

x

x

biosVfPartialMirrorValue4

lmcBiosVfPartialMirrorValue4

x

x

biosVfPcieARISupport

ImcBiosVfPcieARISupport

x

x

biosVfPciePllSsc

ImcBiosVfPciePllSs

x

x

biosVfQpiLinkSpeed

ImcBiosVfQpiLinkSpeed

x

x

biosVfSelectPprType

ImcBiosVfSelectPprTyp

x

x

biosVfSnoopyModeFor2LM

lmcBiosVfSnoopyModeFor2LM

x

x

biosVfSnoopyModeForAD

ImcBiosVfSnoopyModeForAD

x

x

biosVfUFSDisable

lmcBiosVfUFSDisable

x

x

graphicsCardTemperature

lmcGraphicsCardTemperature

x

secureLdap

ImcSecureLdap

x

x

uploadExternalCertificate

lmcUploadExternalCertificate

x

x

uploadExternalPrivateKey

lmcUploadExternalPrivateKey

x

x

New Features for Release 3.0(0)

  • PowerTool modules (Cisco.IMC, Cisco.UCSManager and Cisco.UCSCentral) are compatible with Windows PowerShell 5.1, PowerShell 6.x and PowerShell 7.

  • Cisco.UCS.Core module is renamed to Cisco.UCS.Common.


Note


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


New Features for Release 2.5(3)

This section briefly describes the new features introduced in the Cisco UCS PowerTool suite, Release 2.5(3). For detailed information about the features listed, see the documents listed in the Related Documentation section.

Key Features in Release 2.5(3)

  • Support for the new features in Cisco IMC Release 4.0(4h)

  • Support for the new features in Cisco UCS Manager Release 4.0(4f)

  • Support for the new features in Cisco UCS Central Release 2.0(1j)

  • Support for the specified new and updated cmdlets

New and Updated Cmdlets for Release 2.5(3)

Cisco IMC Release 4.0(4h)

Table 12. Cisco IMC Release 4.0(4h)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

biosVfDCPMMFirmwareDowngrade

IMCBiosVfDCPMMFirmwareDowngrade

x

x

biosVfIntelSpeedSelect

IMCBiosVfIntelSpeedSelect

x

x

memoryPersistentMemoryBackup

IMCMemoryPersistentMemoryBackup

x

x

memoryPersistentMemoryConfigResult

IMCMemoryPersistentMemoryConfigResult

x

memoryPersistentMemoryConfiguration

IMCMemoryPersistentMemoryConfiguration

x

memoryPersistentMemoryDimms

IMCMemoryPersistentMemoryDimms

x

memoryPersistentMemoryGoal

IMCMemoryPersistentMemoryGoal

x

x

x

x

memoryPersistentMemoryImporter

IMCMemoryPersistentMemoryImporter

x

x

memoryPersistentMemoryLocalSecurity

IMCMemoryPersistentMemoryLocalSecurity

x

x

x

x

memoryPersistentMemoryLogical Configuration

IMCMemoryPersistentMemoryLogical Configuration

x

x

memoryPersistentMemoryLogical Namespace

IMCMemoryPersistentMemoryLogical Namespace

x

x

x

x

memoryPersistentMemoryNamespace

IMCMemoryPersistentMemoryNamespace

x

memoryPersistentMemoryNamespace ConfigResult

IMCMemoryPersistentMemoryNamespace ConfigResult

x

memoryPersistentMemoryRegion

IMCMemoryPersistentMemoryRegion

x

memoryPersistentMemorySecurity

IMCMemoryPersistentMemorySecurity

x

x

x

memoryPersistentMemoryUnit

IMCMemoryPersistentMemoryUnit

x

Cisco UCS Manager Release 4.0(4f)

Table 13. Cisco UCS Manager Release 4.0(4f)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

computeAdminAck

UCSMComputeAdminAck

x

x

equipmentPersistentMemoryUnitCap Provider

UCSMequipmentPersistentMemoryUnitCap Provider

x

memoryPersistentMemoryConfig Result

UCSMMemoryPersistentMemoryConfig Result

x

memoryPersistentMemory Configuration

UCSMMemoryPersistentMemory Configuration

x

memoryPersistentMemoryGoal

UCSMMemoryPersistentMemoryGoal

x

x

x

x

memoryPersistentMemoryLocal Security

UCSMMemoryPersistentMemoryLocal Security

x

x

x

x

memoryPersistentMemoryLogical Namespace

UCSMMemoryPersistentMemoryLogical Namespace

x

x

x

x

memoryPersistentMemoryNamespace

UCSMMemoryPersistentMemoryNamespace

x

memoryPersistentMemoryNamespace ConfigResult

UCSMMemoryPersistentMemoryNamespace ConfigResult

x

memoryPersistentMemoryPolicy

UCSMMemoryPersistentMemoryPolicy

x

x

x

x

memoryPersistentMemoryRegion

UCSMMemoryPersistentMemoryRegion

x

memoryPersistentMemorySecurity

UCSMMemoryPersistentMemorySecurity

x

x

x

memoryPersistentMemoryUnit

UCSMMemoryPersistentMemoryUnit

x

Cisco UCS Central Release 2.0(1j)

Table 14. Cisco UCS Central Release 2.0(1j)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

adaptorVmmqConnDef

UCSMComputeAdminAck

x

biosTokenFeatureGroup

UCSMequipmentPersistentMemoryUnit CapProvider

x

biosTokenParam

UCSMMemoryPersistentMemory ConfigResult

x

biosTokenSettings

UCSMMemoryPersistentMemory Configuration

x

x

computeFabricEthMonSrcEp

UCSMMemoryPersistentMemoryGoal

x

computeFabricEthMonSrcEpCont

UCSMMemoryPersistentMemoryLocal Security

x

computeFabricFcMonSrcEp

UCSMMemoryPersistentMemoryLogical Namespace

x

computeFabricFcMonSrcEpCont

UCSMMemoryPersistentMemoryNamespace

x

vnicNetGroup

UCSMMemoryPersistentMemoryNamespace ConfigResult

x

vnicNetGroupRef

UCSMMemoryPersistentMemoryPolicy

x

New Features for Release 2.5(2)

This section briefly describes the new features introduced in the Cisco UCS PowerTool suite, Release 2.5(2). For detailed information about the features listed, see the documents listed in the Related Documentation section.

Key Features in Release 2.5(2)

The following cmdlets are migrated to a new version of API for better performance:

  • Get-UCSSoftwareImageList

  • Get-UCSSoftwareImage

The above cmdlets are deprecated in older versions of PowerTool, and may not continue to work as expected. Cisco recommends that you upgrade to Cisco UCS PowerTool Core Suite Release 2.5.2 to continue using these cmdlets.

New Features for Release 2.5(1)

This section briefly describes the new features introduced in the Cisco UCS PowerTool suite, Release 2.5(1). For detailed information about the features listed, see the documents listed in the Related Documentation section.

Key Features in Release 2.5(1)

  • Support for new features in Cisco IMC Release 4.0(2c)

  • Support for new features in Cisco UCSM Release 4.0(2a)

  • Performance enhancement for the following ASD cmdlets:

    • Get-UcsSoftwareImage

    • Get-UcsSoftwareImageList

  • Support for the following new cmdlets:

    • Get-UcsEquipmentFruVariantStorage

    • Get-UcsEquipmentManufacturingDefStorage

    • Get-UcsEquipmentPhysicalDefStorage

    • Get-UcsEquipmentPictureStorage

    • Get-UcsEquipmentServiceDefStorage

    • Get-UcsEquipmentSlotArrayRefStorage

    • Get-UcsFirmwareUpgradeConstraintStorage

New and Updated Cmdlets for Release 2.5(1)

Cisco IMC Release 4.0(2c)

Table 15. Cisco IMC Release 4.0(2c)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

adapterSecureUpdate

ImcAdapterSecureUpdate

x

x

biosVfBmeDmaMitigation

ImcBiosVfBmeDmaMitigation

x

x

biosVfCbsCmnCpuCpb

ImcBiosVfCbsCmnCpuCpb

x

x

biosVfCbsCmnCpuGen

DowncoreCtrl

ImcBiosVfCbsCmnCpuGen

DowncoreCtrl

x

x

biosVfCbsCmnCpuGlobal

CstateCtrl

ImcBiosVfCbsCmnCpuGlobal

CstateCtrl

x

x

biosVfCbsCmnCpuL1Stream

HwPrefetcher

ImcBiosVfCbsCmnCpuL1Stream

HwPrefetcher

x

x

biosVfCbsCmnCpuL2Stream

HwPrefetcher

ImcBiosVfCbsCmnCpuL2Stream

HwPrefetcher

x

x

biosVfCbsCmnDeterminismSlider

ImcBiosVfCbsCmnDeterminismSlider

x

x

biosVfCbsCmnGnbNbIOMMU

ImcBiosVfCbsCmnGnbNbIOMMU

x

x

biosVfCbsCmnMemCtrlBankGroup

SwapDdr4

ImcBiosVfCbsCmnMemCtrlBankGroup

SwapDdr4

x

x

biosVfCbsCmnMemMapBank

InterleaveDdr4

ImcBiosVfCbsCmnMemMapBank

InterleaveDdr4

x

x

biosVfCbsCmncTDPCtl

ImcBiosVfCbsCmncTDPCtl

x

x

biosVfCbsDfCmnMemIntlv

ImcBiosVfCbsDfCmnMemIntlv

x

x

biosVfCbsDfCmnMemIntlvSize

ImcBiosVfCbsDfCmnMemIntlvSize

x

x

biosVfSMEE

ImcBiosVfSMEE

x

x

biosVfSmtMode

ImcBiosVfSmtMode

x

x

biosVfSvmMode

ImcBiosVfSvmMode

x

x

biosVfVMDEnable

ImcBiosVfVMDEnable

x

x

commSnmpConfigCommit

ImcCommSnmpConfigCommit

x

equipmentRackEnclosure

ImcEquipmentRackEnclosure

x

moInvKv

ImcMoInvKv

x

moKvInvHolder

ImcMoKvInvHolder

x

Cisco UCSM Release 4.0(2a)

The following tables lists the new and updated cmdlets added for all the features in Cisco UCSM Release 4.0(2a):

Table 16. Cisco UCSM Release 4.0(2a)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

aaaLoginProfile

UcsAaaLoginProfile

x

x

biosVfBMEDMAMitigation

UcsBiosVfBMEDMAMitigation

x

x

coprocessorCard

UcsCoprocessorCard

x

equipmentCoprocessorUnit

CapProvider

UcsEquipmentCoprocessorUnit

CapProvider

x

equipmentRackEnclosure

UcsEquipmentRackEnclosure

x

equipmentRackEnclosureCapProvider

UcsEquipmentRackEnclosureCapProvider

x

equipmentSiocCapProvider

UcsEquipmentSiocCapProvider

x

equipmentSlotEp

UcsEquipmentSlotEp

x

equipmentSpeedCompatibility

UcsEquipmentSpeedCompatibility

fabricReservedVlan

UcsFabricReservedVlan

x

x

fabricReservedVlanFsm

UcsFabricReservedVlanFsm

fabricReservedVlanFsmStage

UcsFabricReservedVlanFsmStage

fabricReservedVlanFsmTask

UcsFabricReservedVlanFsmTask

firmwareWaterbaySiocServer

Constraint

UcsFirmwareWaterbaySiocServer

Constraint

x

mgmtLeaderEntity

UcsMgmtLeaderEntity

New Features for Release 2.3(1)

This section briefly describes the new features introduced in the Cisco UCS PowerTool suite, Release 2.3(1). For detailed information about the features listed, see the documents listed in the Related Documentation section.

Key Features in Release 2.3(1)

  • Support for new features in Cisco IMC Release 3.1(1d)

  • Support for new features in Cisco UCS Central Release 2.0(1b)

  • Support for new features in Cisco UCSM Release 3.2(1d)

  • Updated cmdlet Add-UcsCentralServiceProfileFromTemplate to create Service profile with service profile template

  • Added cmdlet Get-UcsCentralPolicyUsage to provide support to fetch policy details for any managed object.

New and Updated Cmdlets for Release 2.3(1)

Cisco IMC Release 3.1(1d)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

biosVfBootOptionNumRetry

ImcBiosVfBootOptionNumRetry

x

x

biosVfBootOptionReCoolDown

ImcBiosVfBootOptionReCoolDown

x

x

biosVfIMCInterleave

ImcBiosVfIMCInterleave

x

x

biosVfIPV6PXE

ImcBiosVfIPV6PXE

x

x

biosVfKTIPrefetch

ImcBiosVfKTIPrefetch

x

x

biosVfLLCPrefetch

ImcBiosVfLLCPrefetch

x

x

biosVfPSata

ImcBiosVfPSata

x

x

biosVfSubNumaClustering

ImcBiosVfSubNumaClustering

x

x

biosVfTPMControl

ImcBiosVfTPMControl

x

x

biosVfXPTPrefetch

ImcBiosVfXPTPrefetch

x

x

lsbootCdd

ImcLsbootCdd

x

x

storageFlexUtilController

ImcStorageFlexUtilController

x

x

storageFlexUtilHealth

ImcStorageFlexUtilHealth

x

storageFlexUtilOperationalProfile

ImcStorageFlexUtil

OperationalProfile

x

x

storageFlexUtilPhysicalDrive

ImcStorageFlexUtilPhysicalDrive

x

storageFlexUtilVirtualDrive

ImcStorageFlexUtilVirtualDrive

x

x

storageFlexUtilVirtualDriveImageMap

ImcStorageFlexUtilVirtualDrive

ImageMap

x

x

storageNVMePhysicalDrive

ImcStorageNVMePhysicalDrive

x

systemBoardUnit

ImcSystemBoardUnit

x

x86LiveDebug

ImcX86LiveDebug

x

Cisco UCS Central Release 2.0(1b)

The following tables lists the new and updated cmdlets added for all the features in Cisco UCS Central Release 2.0(1b):

Cmdlet

Operation

Get-UcsCentralPolicyUsage

Provide support to fetch policy details for any managed object.

Add-UcsCentralServiceProfileFromTemplate

Provide support to create service profile if user selects Advance naming options from the GUI.

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

adaptorExtEthIfOperation

AdaptorExtEthIfOperation

x

x

adaptorHostEthIfOperation

AdaptorHostEthIfOperation

x

x

adaptorHostFcIfOperation

AdaptorHostFcIfOperation

x

x

adaptorHostIscsiIf

AdaptorHostIscsiIf

x

adaptorHostIscsiIfOperation

AdaptorHostIscsiIfOperation

x

x

adaptorUnitExtn

AdaptorUnitExtn

x

biosVfEnergyPerformanceTuning

BiosVfEnergyPerformance

Tuning

 x

x

biosVfEnhancedPowerCappingSupport

BiosVfEnhancedPowerCapping

Support

 x

x

biosVfIOEMezz1OptionROM

BiosVfIOEMezz1OptionROM

 x

x

biosVfIOENVMe1OptionROM

BiosVfIOENVMe1OptionROM

 x

x

biosVfIOENVMe2OptionROM

BiosVfIOENVMe2OptionROM

 x

x

biosVfIOESlot1OptionROM

BiosVfIOESlot1OptionROM

 x

x

biosVfIOESlot2OptionROM

BiosVfIOESlot2OptionROM

 x

x

biosVfOutOfBandManagement

BiosVfOutOfBandManagement

 x

x

biosVfPCHSATAMode

BiosVfPCHSATAMode

 x

x

biosVfPCIROMCLP

BiosVfPCIROMCLP

 x

x

biosVfProcessorCMCI

BiosVfProcessorCMCI

 x

x

biosVfRedirectionAfterBIOSPOST

BiosVfRedirectionAfter

BIOSPOST

 x

x

biosVfSBMezz1OptionROM

BiosVfSBMezz1OptionROM

 x

x

biosVfSBNVMe1OptionROM

BiosVfSBNVMe1OptionROM

 x

x

biosVfSIOC1OptionROM

BiosVfSIOC1OptionROM

 x

x

biosVfSIOC2OptionROM

BiosVfSIOC2OptionROM

 x

x

biosVfTPMSupport

BiosVfTPMSupport

 x

x

biosVfWorkloadConfiguration

BiosVfWorkloadConfiguration

 x

x

computeChassisFeatMask

ComputeChassisFeatMask

x

computeDomainHwChangeDiscPolicy

ComputeDomainHwChange

DiscPolicy

x

x

x

x

computeDomainPortDiscPolicy

ComputeDomainPortDiscPolicy

x

x

x

x

computeFactoryResetOp

ComputeFactoryResetOp

x

x

computeGraphicsCardPolicy

ComputeGraphicsCardPolicy

x

x

x

x

computeGroupMembershipRef

ComputeGroupMembershipRef

x

computeHwChangeDiscPolicy

ComputeHwChangeDiscPolicy

x

x

x

x

computePhysicalExtension

ComputePhysicalExtension

x

computePortDiscPolicy

ComputePortDiscPolicy

x

x

computePowerSyncDef

ComputePowerSyncDef

x

computePowerSyncPolicy

ComputePowerSyncPolicy

x

x

x

x

computeRebootLog

ComputeRebootLog

x

configNetRefItem

ConfigNetRefItem

configSpotLightItem

ConfigSpotLightItem

dcxVIf

DcxVIf

x

diagLogEp

DiagLogEp

x

diagMemoryTest

DiagMemoryTest

x

diagRslt

DiagRslt

x

diagRunPolicy

DiagRunPolicy

x

x

diagSrvCapProvider

DiagSrvCapProvider

x

diagSrvCtrl

DiagSrvCtrl

x

 x

diagSrvCtrlOperation

DiagSrvCtrlOperation

x

x

diagSrvCtrlOperationFsmTask

DiagSrvCtrlOperationFsmTask

domainChassisFeature

DomainChassisFeature

x

domainChassisParam

DomainChassisParam

x

domainProfile

DomainProfile

x

x

domainProfileFsmTask

DomainProfileFsmTask

equipmentChassisProfileFsmTask

EquipmentChassisProfileFsmTask

equipmentComputeConn

EquipmentComputeConn

x

equipmentComputeConnPolicy

EquipmentComputeConnPolicy

x

x

x

x

equipmentDriveSecCap

EquipmentDriveSecCap

x

equipmentFruVariant

EquipmentFruVariant

x

fabricFcEndpoint

FabricFcEndpoint

x

fabricFcUserZone

FabricFcUserZone

x

fabricFcUserZoneIvt

FabricFcUserZoneIvt

fabricFcZoneProfile

FabricFcZoneProfile

x

fabricFcZoneProfileFsmTask

FabricFcZoneProfileFsmTask

fabricFcZoneProfileIvt

FabricFcZoneProfileIvt

x

fabricNetGroupEp

FabricNetGroupEp

x

fabricNetGroupPermit

FabricNetGroupPermit

fabricNetGroupRef

FabricNetGroupRef

fabricNetGroupReq

FabricNetGroupReq

fabricSanGroup

FabricSanGroup

x

fabricSanGroupRef

FabricSanGroupRef

fdBlade

FdBlade

x

x

fdChassis

FdChassis

x

fdPhysicalFsmTask

FdPhysicalFsmTask

fdRackUnit

FdRackUnit

x

featureChassisDef

FeatureChassisDef

x

firmwareAck

FirmwareAck

x

x

inbandPolicy

InbandPolicy

x

x

inventoryDomainEp

InventoryDomainEp

x

x

inventoryEp

InventoryEp

x

inventoryGlobalEp

InventoryGlobalEp

 x

inventoryHolder

InventoryHolder

 x

inventoryInventoryMoMeta

InventoryInventoryMoMeta

 x

lstorageDriveSecurity

LstorageDriveSecurity

x

x

x

lstorageLocal

LstorageLocal

x

x

x

x

lstorageLocalDef

LstorageLocalDef

lstorageLogin

LstorageLogin

x

x

x

x

lstorageRemote

LstorageRemote

x

x

x

x

lstorageRemoteDef

LstorageRemoteDef

lstorageSecurity

LstorageSecurity

x

x

x

x

mgmtKmip

MgmtKmip

x

mgmtKmipCertPolicy

MgmtKmipCertPolicy

x

x

x

x

mgmtKmipOperation

MgmtKmipOperation

x

x

mgmtNamedKmipCertPolicy

MgmtNamedKmipCertPolicy

x

x

x

x

mgmtSecurity

MgmtSecurity

x

netNetGroupPermit

NetNetGroupPermit

networkElementOperation

NetworkElementOperation

x

x

policyChildClass

PolicyChildClass

x

policyConfigError

PolicyConfigError

x

policyContext

PolicyContext

x

policyDestClass

PolicyDestClass

x

policyDestEp

PolicyDestEp

x

policyPolicyDestClass

PolicyPolicyDestClass

x

policyRequestor

PolicyRequestor

x

policyScope

PolicyScope

x

policySourceApp

PolicySourceApp

x

qosclassPolicy

QosclassPolicy

x

x

x

x

storageDiskEnvStats

StorageDiskEnvStats

storageDiskEnvStatsHist

StorageDiskEnvStatsHist

storageFlexFlashControllerOperation

StorageFlexFlashController

Operation

 x

storageNvmeStats

StorageNvmeStats

storageNvmeStatsHist

StorageNvmeStatsHist

storageNvmeStorage

StorageNvmeStorage

storageSsdHealthStats

StorageSsdHealthStats

storageSsdHealthStatsHist

StorageSsdHealthStatsHist

storageVsanRefIvt

StorageVsanRefIvt

 x

sysdebugDiagnosticLog

SysdebugDiagnosticLog

 x

vnicIniGrpFcB

VnicIniGrpFcB

x

vnicIniGrpFcBIf

VnicIniGrpFcBIf

x

vnicOutbandMgmtEp

VnicOutbandMgmtEp

x

vnicOutbandMgmtEpFsmTask

VnicOutbandMgmtEpFsmTask

Cisco UCSM Release 3.2(1d)

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

biosTokenFeatureGroup

BiosTokenFeatureGroup

x

biosTokenParam

BiosTokenParam

x

biosTokenSettings

BiosTokenSettings

x

 x

computeGraphicsCardPolicy

ComputeGraphicsCardPolicy

computeHwChangeDiscPolicy

ComputeHwChangeDiscPolicy

 x

x

computePhysicalExtension

ComputePhysicalExtension

computePortDiscPolicy

ComputePortDiscPolicy

 x

x

computeRebootLog

ComputeRebootLog

controllerMgmtDbCheckPol

ControllerMgmtDbCheckPol

 x

x

diagLogEp

DiagLogEp

diagMemoryTest

DiagMemoryTest

 x

x

domainChassisFeature

DomainChassisFeature

 x

x

domainChassisFeatureCont

DomainChassisFeatureCont

domainChassisParam

DomainChassisParam

 x

x

equipmentBiosTokenOverride

EquipmentBiosTokenOverride

 x

x

equipmentComputeConn

EquipmentComputeConn

equipmentComputeConnPolicy

EquipmentComputeConnPolicy

 x

x

equipmentDriveSecCap

EquipmentDriveSecCap

x

equipmentHostMgmtControllerCap

EquipmentHostMgmt

ControllerCap

equipmentHxCap

EquipmentHxCap

x

equipmentInventoryStatus

EquipmentInventoryStatus

 x

x

equipmentMiniStorageCapProvider

EquipmentMiniStorage

CapProvider

 x

x

equipmentNvmeDef

EquipmentNvmeDef

 x

fabricNetGroupRef

FabricNetGroupRef

fabricSanGroup

FabricSanGroup

 x

x

fabricSanGroupRef

FabricSanGroupRef

fabricVlanGroupPermit

FabricVlanGroupPermit

firmwareDriveSecurityConstraint

FirmwareDriveSecurityConstraint

firmwareDualVicChassisConstraint

FirmwareDualVicChassisConstraint

firmwareDualVicServerConstraint

FirmwareDualVicServerConstraint

firmwareModule

FirmwareModule

firmwareSecondControllerChassisConstraint

FirmwareSecondController

ChassisConstraint

firmwareSecondControllerServerConstraint

FirmwareSecondController

ServerConstraint

firmwareServicePack

FirmwareServicePack

 x

x

lsbootNvme

LsbootNvme

 x

x

lsbootNvmeDiskSsd

LsbootNvmeDiskSsd

 x

x

lsbootNvmePciSsd

LsbootNvmePciSsd

 x

x

lstorageDriveSecurity

LstorageDriveSecurity

x

lstorageLocal

LstorageLocal

x

x

lstorageLocalDef

LstorageLocalDef

x

lstorageLogin

LstorageLogin

x

x

lstorageRemote

LstorageRemote

x

x

lstorageRemoteDef

LstorageRemoteDef

x

lstorageSecurity

LstorageSecurity

x

x

mgmtDbState

MgmtDbState

 x

x

mgmtKmip

MgmtKmip

x

x

mgmtKmipCertPolicy

MgmtKmipCertPolicy

x

x

mgmtSecurity

MgmtSecurity

x

moInvKv

MoInvKv

 x

x

moIpV4AddrKv

MoIpV4AddrKv

 x

x

moIpV6AddrKv

MoIpV6AddrKv

 x

x

moKv

MoKv

 x

x

moKvCfgHolder

MoKvCfgHolder

 x

x

moKvInvHolder

MoKvInvHolder

moVnicKv

MoVnicKv

 x

x

networkLimit

NetworkLimit

policyChildClass

PolicyChildClass

policyConfigError

PolicyConfigError

policyContext

PolicyContext

policyDestClass

PolicyDestClass

policyDestEp

PolicyDestEp

policyPolicyDestClass

PolicyPolicyDestClass

policyPolicyScopeContFsm

PolicyPolicyScopeContFsm

policyPolicyScopeContFsmStage

PolicyPolicyScopeContFsmStage

policyPolicyScopeContFsmTask

PolicyPolicyScopeContFsmTask

policyRequestor

PolicyRequestor

policyRequestorFsm

PolicyRequestorFsm

policyRequestorFsmStage

PolicyRequestorFsmStage

policyRequestorFsmTask

PolicyRequestorFsmTask

policyScope

PolicyScope

policySourceApp

PolicySourceApp

storageControllerReference

StorageControllerReference

storageMiniStorage

StorageMiniStorage

x

storageNvmeStorage

StorageNvmeStorage

x

storageSsdHealthStats

StorageSsdHealthStats

x

storageSsdHealthStatsHist

StorageSsdHealthStatsHist

x

swEtherPort

SwEtherPort

swPortDiscover

SwPortDiscover

swPortDiscoverFsm

SwPortDiscoverFsm

swPortDiscoverFsmStage

SwPortDiscoverFsmStage

swPortDiscoverFsmTask

SwPortDiscoverFsmTask

sysdebugDiagnosticLog

SysdebugDiagnosticLog

 x

x

sysdebugDiagnosticLogRepository

SysdebugDiagnosticLog

Repository

New Features for Release 2.2(1)

This section briefly describes the new features introduced in the Cisco UCS PowerTool suite, Release 2.1(1). For detailed information about the features listed, see the documents listed in the Related Documentation section.

Key Features in Release 2.2(1)

  • Support for new features in Cisco IMC Release 3.0(1c) and 3.0(2b)

  • Support to launch the UCS Manager HTML GUI automatic login

  • Support to specify the JSON file as input for uploading the hardware profile to HCL Tool

  • Support to collect advisories for the hardware profile in HCL Tool cmdlet

  • Security enhancement to HCL Tool cmdlets

New Aliases

The following table lists the aliases added to support Cisco IMC Release 3.0(1c) features:

Alias

Operation

Enable-ImcBiosProfile

Activates the selected BIOS profile.

Remove-ImcBiosProfile

Deletes the selected BIOS profile.

Reset-ImcEventFilters

Reset all the Event Filters.

Backup-ImcBiosProfile

Backups the BIOS configuration by deleting the existing BIOS profile and creating a new profile with the existing backup file. If no backup file exists, then a new backup file is created.

Also, it activates the backed-up BIOS profile to the previous configuration.

Clear-ImcOneTimePrecisionBootDevice

Clears the One Time Boot Device configured.

The following table lists the aliases added to support Cisco IMC Release 3.0(2b) features:

Alias

Operation

Remove-ImcRootCACertificate

Deletes the root CA certificate.

Remove-ImcClientCertificate

Deletes the client certificate.

Remove-ImcClientPrivateKey

Deletes the client private key.

Clear-ImcKmipLogin

Deletes the KMIP login details.

Clear-ImcKmipServer

Clears the KMIP server details.

New Cmdlets for Release 2.2(1)

Cisco IMC Release 3.0(2b)

The following tables lists the new cmdlets added for all the features in Cisco IMC Release 3.0(2b):

Cmdlet

Operation

Send-ImcKmipEntity

Provides an option to upload a KMIP entity, such as:

  • Root CA Certificate

  • Client Certificate

  • Client Private Key

Receive-ImcKmipEntity

Provides an option to download a KMIP entity, such as:

  • Root CA Certificate

  • Client Certificate

  • Client Private Key

Get-ImcKmipDownloadStatus

Provides an option to get the upload status of a KMIP entity, such as:

  • Root CA Certificate

  • Client Certificate

  • Client Private Key

Get-ImcKmipUploadStatus

Provides an option to get the download status of a KMIP entity, such as:

  • Root CA Certificate

  • Client Certificate

  • Client Private Key

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

kmipManagement

KmipManagement

x

x

kmipServer

KmipServer

x

x

kmipServerLogin

KmipServerLogin

x

x

Cisco IMC Release 3.0(1c)

The following tables lists the new cmdlets added for all the features in Cisco IMC Release 3.0(1c):

Cmdlet

Operation

Export-ImcHardwareInventory

Exports the hardware inventory of the system to a remote location.

Send-ImcBiosProfile

Uploads the BIOS profile to the CIMC from a remote location.

Start-ImcOsInstallation

Starts the NI-SCU OS installation process.

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

aaaUserPasswordExpiration

UserPasswordExpiration

x

x

biosProfile

biosProfile

x

x

x

biosProfileManagement

biosProfileManagement

x

x

biosProfileToken

biosProfileToken

x

biosVfPowerOnPasswordSupport

biosVfPowerOnPasswordSupport

x

x

commSavedVMediaMap

commSavedVMediaMap

x

x

x

commRedfish

commRedfish

x

x

fanPolicy

fanPolicy

x

x

generateRandomPassword

generateRandomPassword

x

ipFiltering

ipFiltering

x

x

oneTimePrecisionBootDevice

oneTimePrecisionBootDevice

x

x

osiController

OSInstallationController

x

osiStart

OSInstallation

x

osiStatus

OSInstallationStatus

x

New Features for Release 2.1(1)

This section briefly describes the new features introduced in Cisco UCS PowerTool suite, Release 2.1(1). For detailed information about the features listed, see the documents listed in the Related Documentation section.

Key Features in Release 2.1(1)

  • New cmdlets added to interact with the Cisco UCS Hardware and software Compatibility List (HCL) tool

  • Support for new features in UCS Manager Release 3.1(2)

  • Support for new features in Cisco IMC Release 2.0(10), and 2.0(13)

  • Support for new features in Cisco UCS Central Release 1.5

  • Support to launch KVM session using both in-band and out-of-band management IP addresses in UCS Manager PowerTool

  • Enhancements to ConvertTo-UcsDSCConfig cmdlet to support reading from the log file and to generate the corresponding cmdlet

  • Support to launch UCS Manager HTML GUI

New Aliases

The following table lists the aliases added to support Cisco IMC Release 2.0(13) features:

Alias

Operation

Remove-ImcLdapCACertificate

Delete LDAP CA Certificate

Test-ImcLdapBinding

Test LDAP Binding

Reset-ImcPlatformEventFilters

Reset Platform Event filters

Enable-ImcPidCatalog

Activate PID Catalog

The following table lists the aliases added to perform storage operations:

Alias

Operation

Reset-ImcStorageController

Deletes all virtual drives and reset the physical drives

Clear-ImcBootDrive

Clears boot drive

Clear-ImcForeignConfig

Clears foreign configuration

Disable-ImcJbod

Disables JBOD

Enable-ImcJbod

Enables JBOD

Get-ImcTtyLog

Gets TTY log

Import-ImcForeignConfig

Imports foreign configuration

New Cmdlets for Release 2.1(1)

Cisco UCS Manager:

The following table lists new cmdlets added for all the features in UCS Manager, Release 3.1(2):

MO Name

Noun

Get

Set

Add

Remove

adaptorEthAdvFilterProfile

AdaptorEthAdvFilterProfile

x

x

x

adaptorEthInterruptScalingProfile

AdaptorEthInterruptScalingProfile

x

x

x

x

adaptorFcFnicProfile

AdaptorFcFnicProfile

x

x

x

x

biosVfEnergyPerformanceTuning

BiosVfEnergyPerformanceTuning

x

x

biosVfIOEMezz1OptionROM

BiosVfIOEMezz1OptionROM

x

x

biosVfIOENVMe1OptionROM

BiosVfIOENVMe1OptionROM

x

x

biosVfIOENVMe2OptionROM

BiosVfIOENVMe2OptionROM

x

x

biosVfIOESlot1OptionROM

BiosVfIOESlot1OptionROM

x

x

biosVfIOESlot2OptionROM

BiosVfIOESlot2OptionROM

x

x

biosVfOutOfBandManagement

BiosVfOutOfBandManagement

x

x

biosVfPCIROMCLP

BiosVfPCIROMCLP

x

x

biosVfProcessorCMCI

BiosVfProcessorCMCI

x

x

biosVfRedirectionAfterBIOSPOST

BiosVfRedirectionAfter BIOSPOST

x

x

biosVfSBMezz1OptionROM

BiosVfSBMezz1OptionROM

x

x

biosVfSBNVMe1OptionROM

BiosVfSBNVMe1OptionROM

x

x

biosVfSIOC1OptionROM

BiosVfSIOC1OptionROM

x

x

biosVfSIOC2OptionROM

BiosVfSIOC2OptionROM

x

x

biosVfWorkloadConfiguration

BiosVfWorkloadConfiguration

x

x

computeFactoryResetOperation

ComputeFactoryResetOperation

x

x

x

x

computePowerSyncDef

ComputePowerSyncDef

x

x

computePowerSyncPolicy

ComputePowerSyncPolicy

x

x

x

x

controllerHaController

ControllerHaController

x

x

controllerOperationalVersionHolder

ControllerOperationalVersion Holder

x

controllerPreferedVersionHolder

ControllerPreferedVersion Holder

x

x

x

cpmaintAck

CpmaintAck

x

x

cpmaintMaintPolicy

CpmaintMaintPolicy

x

x

x

x

equipmentBinding

EquipmentBinding

x

x

equipmentCapModSpec

EquipmentCapModSpec

x

equipmentChassisIssues

EquipmentChassisIssues

x

equipmentChassisProfile

EquipmentChassisProfile

x

x

x

x

equipmentChassisProfileAssocCtx

EquipmentChassisProfile AssocCtx

x

equipmentFruVariant

EquipmentFruVariant

x

equipmentHwCapDerivativeProvider

EquipmentHwCap DerivativeProvider

x

equipmentHwRevisionModifier

EquipmentHwRevisionModifier

x

equipmentIOExpander

EquipmentIOExpander

x

equipmentIOExpanderCapProvider

EquipmentIOExpanderCapProvider

x

equipmentPciSlotIdEntry

EquipmentPciSlotIdEntry

x

equipmentPciSlotIdMapping

EquipmentPciSlotIdMapping

x

equipmentPciSlotSubOEMIdEntry

EquipmentPciSlotSubOEMIdEntry

x

equipmentSiocTempStats

EquipmentSiocTempStats

x

equipmentSiocTempStatsHist

EquipmentSiocTempStatsHist

x

equipmentStorageEncCapProvider

EquipmentStorageEnc CapProvider

x

equipmentStorageSasExpanderDef

EquipmentStorageSas ExpanderDef

x

equipmentSystemIOController

EquipmentSystemIOController

x

x

fabricFcEndpoint

FabricFcEndpoint

x

x

x

x

fabricFcUserZone

FabricFcUserZone

x

x

x

x

fabricFcZoneProfile

FabricFcZoneProfile

x

x

x

x

firmwareActivityTrigger

FirmwareActivityTrigger

x

firmwareChassisComponentSpec

FirmwareChassisComponent Spec

x

firmwareChassisPack

FirmwareChassisPack

x

x

x

x

firmwareExcludeChassisComponent

FirmwareExcludeChassis Component

x

x

x

lsbootEFIShell

LsbootEFIShell

x

x

x

x

lstorageControllerRef

LstorageControllerRef

x

x

x

lstorageDiskSlot

LstorageDiskSlot

x

x

x

x

lstorageDiskZoningConfigDef

LstorageDiskZoningConfigDef

x

x

x

x

lstorageDiskZoningPolicy

LstorageDiskZoningPolicy

x

x

x

x

mgmtCmcSecureBoot

MgmtCmcSecureBoot

x

x

morefFruRef

MorefFruRef

x

x

x

x

morefImportRoot

MorefImportRoot

x

x

x

x

morefProp

MorefProp

x

x

x

x

morefRef

MorefRef

x

x

x

x

powerFexMember

PowerFexMember

x

x

x

powerFIMember

PowerFIMember

x

x

x

x

sesDiskSlotEp

SesDiskSlotEp

x

sesEnclosure

SesEnclosure

x

storageControllerEp

StorageControllerEp

x

storageControllerRef

StorageControllerRef

x

storageEmbeddedStorage

StorageEmbeddedStorage

x

storageEnclosureCap

StorageEnclosureCap

x

storageEnclosureDiskSlotEp

StorageEnclosureDiskSlotEp

x

storageHddMotherBoardTempStats

StorageHddMotherBoard TempStats

x

storageHddMotherBoard TempStatsHist

StorageHddMotherBoard TempStatsHist

x

storageLocalDiskEp

StorageLocalDiskEp

x

storageNvmeStats

StorageNvmeStats

x

storageNvmeStatsHist

StorageNvmeStatsHist

x

storageSasLinkDescriptor

StorageSasLinkDescriptor

x

storageSasPort

StorageSasPort

x

storageSasPortDescriptor

StorageSasPortDescriptor

x

storageSasUpLink

StorageSasUpLink

x

storageVirtualDriveContainer

StorageVirtualDriveContainer

x

storageVirtualDriveEp

StorageVirtualDriveEp

x

swFcEndpoint

SwFcEndpoint

x

swFcUserZone

SwFcUserZone

x

swFcUserZoneGroup

SwFcUserZoneGroup

x

Cisco IMC

The following table lists new cmdlets added for all the features in Cisco IMC, Release 2.0(13):

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

activatePIDCatalog

ActivatePIDCatalog

x

x

adaptorEthRdmaProfile

AdaptorEthRdmaProfile

x

x

biosVfCmciEnable

BiosVfCmciEnable

x

x

biosVfPCIeSSDHot PlugSupport

BiosVfPCIeSSDHot PlugSupport

x

x

downloadLdapCACertificate

DownloadLdapCACertificate

x

eventManagement

EventManagement

x

x

exportLdapCACertificate

ExportLdapCACertificate

x

ldapCACertificate

LdapCACertificate

x

x

ldapCACertificateManagement

LdapCACertificateManagement

x

x

lsbootNVMe

LsbootNVMe

x

x

platformEventFilters

PlatformEventFilters

x

x

storageControllerHealth

StorageControllerHealth

x

storageControllerNVMe

StorageControllerNVMe

x

storageSasExpander

StorageSasExpander

x

uploadPIDCatalog

UploadPIDCatalog

x

The following table lists new cmdlets added for all the features in Cisco IMC, Release 2.0(13) for UCS 3x60 server:

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

autoPowerProfile

AutoPowerProfile

x

x

bmcResetReason

BmcResetReason

x

chassisPIDCatalog

ChassisPIDCatalog

x

chassisPowerBudget

ChassisPowerBudget

x

chassisPowerMonitor

ChassisPowerMonitor

x

chassisPowerUtilization

ChassisPowerUtilization

x

commEpIpmiLan

CommEpIpmiLan

x

x

computeServerNode

ServerNode

x

customPowerProfile

CustomPowerProfile

x

equipmentSystemIOController

EquipmentSystemIOController

x

mgmtBackupServer

MgmtBackupServer

x

mgmtImporterServer

MgmtImporterServer

x

storageEnclosure

StorageEnclosure

x

storageEnclosure DiskFwHelper

StorageEnclosure DiskFwHelper

x

storageEnclosure DiskSlotZoneHelper

StorageEnclosure DiskSlotZoneHelper

x

thermalPowerProfile

ThermalPowerProfile

x

The following table lists new cmdlets added for all the features in Cisco IMC, Release 2.0(10):

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

biosVfAutonumous CstateEnable

BiosVfAutonumous CstateEnable

x

x

biosVfHWPMEnable

BiosVfHWPMEnable

x

x

Cisco UCS Central

The following table lists new cmdlets added for all the features in UCS Central, Release 1.5:

MO Name

Noun

Get

Set

Add

Remove

adaptorEthAdvFilterProfile

AdaptorEthAdvFilterProfile

x

x

adaptorEthInterruptScalingProfile

AdaptorEthInterrupt ScalingProfile

x

x

adaptorFcFnicProfile

AdaptorFcFnicProfile

x

x

adaptorHostIfConfig

AdaptorHostIfConfig

x

computeChassisConnPolicy

ComputeChassis ConnPolicy

x

x

computeChassisConn PolicyOperation

ComputeChassis ConnPolicyOperation

x

x

computeFactoryResetOperation

ComputeFactory ResetOperation

x

x

cpmaintAck

CpmaintAck

x

x

cpmaintMaintPolicy

CpmaintMaintPolicy

x

x

x

x

equipmentBinding

EquipmentBinding

x

x

x

x

equipmentCPMeta

EquipmentCPMeta

x

equipmentChassisAssocCtx

EquipmentChassis AssocCtx

x

equipmentChassisIssues

EquipmentChassisIssues

x

equipmentChassisProfile

EquipmentChassisProfile

x

x

x

x

equipmentChassisProfileAssocCtx

EquipmentChassis ProfileAssocCtx

x

equipmentChassisRequirement

EquipmentChassis Requirement

x

equipmentInstance

EquipmentInstance

x

equipmentInstanceMapping

EquipmentInstance Mapping

x

equipmentPciDef

EquipmentPciDef

x

equipmentRequirement

EquipmentRequirement

x

equipmentSiocTempStats

EquipmentSiocTempStats

x

equipmentSiocTempStatsHist

EquipmentSioc TempStatsHist

x

equipmentSystemIOController

EquipmentSystem IOController

x

equipmentSystem IOControllerOperation

EquipmentSystem IOControllerOperation

x

x

equipmentTemplate

EquipmentTemplate

x

equipmentTemplateMapping

EquipmentTemplate Mapping

x

fabricDceSwSrvPc

FabricDceSwSrvPc

x

fabricDceSwSrvPcEp

FabricDceSwSrvPcEp

x

fabricDceSwSrvPcEpOperation

FabricDceSwSrv PcEpOperation

x

x

x

x

fabricDceSwSrvPcOperation

FabricDceSwSrv PcOperation

x

x

x

x

fabricDomainEp

FabricDomainEp

x

fabricEthMon

FabricEthMon

x

fabricEthMonDestEp

FabricEthMonDestEp

x

fabricEthMonDestEpOperation

FabricEthMon DestEpOperation

x

x

x

x

fabricEthMonLan

FabricEthMonLan

x

fabricEthMonOperation

FabricEthMonOperation

x

x

x

x

fabricEthMonSrcEp

FabricEthMonSrcEp

x

fabricEthMonSrcEpOperation

FabricEthMonSrcEp Operation

x

x

x

x

fabricEthMonSrcRef

FabricEthMonSrcRef

x

fabricFcMon

FabricFcMon

x

fabricFcMonDestEp

FabricFcMonDestEp

x

fabricFcMonDestEpOperation

FabricFcMonDestEp Operation

x

x

x

x

fabricFcMonOperation

FabricFcMonOperation

x

x

x

x

fabricFcMonSan

FabricFcMonSan

x

fabricFcMonSrcEp

FabricFcMonSrcEp

x

fabricFcMonSrcEpOperation

FabricFcMonSrcEp Operation

x

x

x

x

fabricFcMonSrcRef

FabricFcMonSrcRef

x

fabricHolder

FabricHolder

x

fabricLanMonCloud

FabricLanMonCloud

x

fabricSanMonCloud

FabricSanMonCloud

x

fabricSystem

FabricSystem

x

firmwareCatalogPackConfig

FirmwareCatalogPack Config

x

x

x

x

firmwareChassisComponentSpec

FirmwareChassisComponent Spec

x

firmwareChassisPack

FirmwareChassisPack

x

x

x

x

firmwareConnectionPolicy

FirmwareConnection Policy

x

x

firmwareDomainInfo

FirmwareDomainInfo

x

firmwareDomainInfraProfile

FirmwareDomainInfra Profile

x

x

x

x

firmwareExcludeChassis Component

FirmwareExcludeChassis Component

x

x

x

x

firmwareInfraPackConfig

FirmwareInfraPackConfig

x

x

x

x

hcAdmin

HcAdmin

x

hcCatalogList

HcCatalogList

x

hcCatalogSource

HcCatalogSource

x

hcCatalogVersion

HcCatalogVersion

x

hcCleanup

HcCleanup

x

hcDownloadPolicy

HcDownloadPolicy

x

hcDownloader

HcDownloader

x

x

x

x

hcHolder

HcHolder

x

hcReport

HcReport

x

x

x

x

hcScopeDn

HcScopeDn

x

x

x

x

lsIdentityInfo

LsIdentityInfo

x

lsbootEFIShell

LsbootEFIShell

x

x

x

x

lstorageControllerRef

LstorageControllerRef

x

x

x

x

lstorageDiskSlot

LstorageDiskSlot

x

x

x

x

lstorageDiskZoningPolicy

LstorageDiskZoningPolicy

x

x

x

x

mgmtCmcSecureBoot

MgmtCmcSecureBoot

x

mgmtCmcSecureBootOperation

MgmtCmcSecureBoot Operation

x

x

orgDomainFirmwareInfo

OrgDomainFirmwareInfo

x

orgMaintTagFirmwareReport

OrgMaintTagFirmware Report

x

policyCommunicationOp

PolicyCommunicationOp

x

x

policyConfigBackupOp

PolicyConfigBackupOp

x

x

policyControlEpOp

PolicyControlEpOp

x

x

x

x

policyDateTimeOp

PolicyDateTimeOp

x

x

policyDiscoveryOp

PolicyDiscoveryOp

x

x

policyDnsOp

PolicyDnsOp

x

x

policyEquipmentOp

PolicyEquipmentOp

x

x

policyFaultOp

PolicyFaultOp

x

x

policyInfraFirmwareOp

PolicyInfraFirmwareOp

x

x

policyMEpOp

PolicyMEpOp

x

x

policyMonitoringOp

PolicyMonitoringOp

x

x

policyPortConfigOp

PolicyPortConfigOp

x

x

policyPowerMgmtOp

PolicyPowerMgmtOp

x

x

policyPsuOp

PolicyPsuOp

x

x

policySecurityOp

PolicySecurityOp

x

x

policyStorageAutoConfigOp

PolicyStorageAuto ConfigOp

x

x

storageControllerEp

StorageControllerEp

x

storageControllerRef

StorageControllerRef

x

storageEmbeddedStorage

StorageEmbedded Storage

x

storageEnclosureDiskSlotEp

StorageEnclosureDisk SlotEp

x

storageEnclosureLocalDiskConfig

StorageEnclosureLocal DiskConfig

x

storageOnboardDevice

StorageOnboardDevice

x

storageSasPort

StorageSasPort

x

storageSasUpLink

StorageSasUpLink

x

storageVirtualDriveContainer

StorageVirtualDrive Container

x

storageVirtualDriveEp

StorageVirtualDriveEp

x

sysdebugTechSupportOp

SysdebugTechSupportOp

x

x

x

x

tagDef

TagDef

x

x

x

x

tagDriver

TagDriver

x

x

x

x

tagInstance

TagInstance

x

x

x

x

tagSoftwareInst

TagSoftwareInst

x

x

x

x

vnicMonSesFc

VnicMonSesFc

x

vnicMonSesFcIf

VnicMonSesFcIf

x

New Features for Release 2.0(2)

This section briefly describes the new features introduced in Cisco UCS PowerTool suite, Release 2.0(2). For detailed information about the features listed, see the documents listed in the Related Documentation section.

Key Features in Release 2.0(2

  • Support to upgrade from Release 2.0(1)

  • Enhancements to Get-UcsSoftwareImageList cmdlet:

    • Support for -AllReleases switch parameter. This parameter enables to retrieve list of all the available images in cisco.com for the selected device type

    • -Version parameter is not supported from this release onwards

New Features for Release 2.0(1)

This section briefly describes the new features introduced in Cisco UCS PowerTool suite, Release 2.x. For detailed information about the features listed, see the documents listed in the Related Documentation section.

Key Features in Release 2.0(1)

  • Support for new features in UCS Manager Release 3.1

  • Support for new features in Cisco IMC Release 2.0(9)

  • Support for new features in Cisco UCS Central Release 1.4

  • Unified installer—Supports unified installer for installing the Cisco UCS Manager, Cisco UCS Central, and Cisco IMC PowerShell modules

  • Custom resources for managing Cisco UCS using Windows PowerShell DSC

    • For Cisco UCS Manager:
      • UcsManagedObject resource - Configures any UCS Manager Managed Object (MO) by specifying the MO details

      • UcsSyncFromBackup resource - Applies the configuration from a backup file to multiple Cisco UCS Manager

      • UcsSyncMoWithReference resource: Synchronizes the configuration from a reference Cisco UCS Manager to any Cisco UCS Manager

      • UcsScript resource - Executes Cisco UCS Manager PowerTool cmdlets

    • For Cisco IMC:

      • ImcManagedObject resource - Configures Cisco IMC MO by specifying the MO details

      • ImcScript resource - Executes Cisco IMC PowerTool cmdlets

  • Support for Cisco UCS core module with cmdlets for features or actions common to all modules

Module Name Changes in Release 2.0(1)

The following table lists the module name changes in this release:

Previous Module Name

New Module Name

CiscoUcsCentralPS

Cisco.UCSCentral

CiscoImcPS

Cisco.IMC

CiscoUcsPS

Cisco.UCSManager

New Cmdlets for Release 2.0(1)

Cisco UCS Manager:

The following table lists new cmdlets added for all the features in UCS Manager, Release 3.1(1):

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

fabricBreakout

FabricBreakout

x

x

x

fabricCablingSw

FabricCablingSw

x

fabricLanCloudPolicy

FabricLanCloudPolicy

x

firmwareExcludeServer

Component

FirmwareExcludeServerComponent

x

x

x

firmwarePCHStorageConfig

Constraint

FirmwarePCHStorageConfigConstraint

x

firmwareServerType

Constraint

FirmwareServerTypeConstraint

x

lsbootEmbeddedLocal

DiskImage

LsbootEmbeddedLocalDiskImage

x

x

x

x

lsbootEmbeddedLocal

DiskImagePath

LsbootEmbeddedLocalDiskImagePath

x

x

x

x

lsbootEmbeddedLocal

LunImage

LsbootEmbeddedLocalLunImage

x

x

x

x

lstorageControllerDef

LstorageControllerDef

x

x

x

lstorageControllerModeConfig

LstorageControllerModeConfig

x

x

x

x

mgmtHealthAttr

MgmtHealthAttr

x

mgmtHealthStatus

MgmtHealthStatus

x

policyEquipment

PolicyEquipment

x

x

policyPortConfig

PolicyPortConfig

x

x

securityUnit

SecurityUnit

x

swVIFRef

SwVIFRef

x

topInfoSyncPolicy

TopInfoSyncPolicy

x

Cisco IMC

The following table lists new cmdlets added for all the features in Cisco IMC, Release 2.0(9):

Managed Object (MO)

PowerShell Noun

Get

Set

Add

Remove

certificateManagement

CertificateManagement

x

selfEncryptStorageController

SelfEncryptStorageController

x

x

aaaUserPolicy

AaaUserPolicy

x

x

generatedStorageControllerKeyId

GeneratedStorageControllerKeyId

x

suggestedStorageControllerSecuritykey

SuggestedStorageControllerSecurityKey

x

Cisco UCS Central

The following table lists new cmdlets added for all the features in UCS Central, Release 1.4(1):

Managed Object (MP)

PowerShell Noun

Get

Set

Add

Remove

adaptorRnicCapSpec

AdaptorRnicCapSpec

x

biosVfAltitude

BiosVfAltitude

x

x

biosVfASPMSupport

BiosVfASPMSupport

x

x

biosVfConsistentDeviceNameControl

BiosVfConsistentDeviceNameControl

x

x

biosVfCPUPowerManagement

BiosVfCPUPowerManagement

x

x

biosVfDDR3VoltageSelection

BiosVfDDR3VoltageSelection

x

x

biosVfIntelTrustedExecutionTechnology

BiosVfIntelTrustedExecutionTechnology

x

x

biosVfPCILOMPortsConfiguration

BiosVfPCILOMPortsConfiguration

x

x

biosVfQPISnoopMode

BiosVfQPISnoopMode

x

x

biosVfTPMPendingOperation

BiosVfTPMPendingOperation

x

x

biosVfTrustedPlatformModule

BiosVfTrustedPlatformModule

x

x

biosVfUSBConfiguration

BiosVfUSBConfiguration

x

x

callhomeFaultInst

CallhomeFaultInst

x

callhomeHolder

CallhomeHolder

x

callhomeHolderFsm

CallhomeHolderFsm

x

callhomeHolderFsmStage

CallhomeHolderFsmStage

x

callhomeHolderFsmTask

CallhomeHolderFsmTask

x

callhomeHttp

CallhomeHttp

x

x

computeAutoconfigPolicy

ServerAutoconfigPolicy

x

x

computeBladeDiscPolicy

BladeDiscoveryPolicy

x

x

x

x

computeBladeInheritPolicy

ServerInheritPolicy

x

x

x

x

computeBoardController

ComputeBoardController

x

computeDomainGroupQual

ComputeDomainGroupQual

x

x

x

x

computeDomainNameQual

ComputeDomainNameQual

x

x

x

computeProductFamilyQual

ComputeProductFamilyQual

x

x

x

computeServerMgmtPolicy

ComputeServerMgmtPolicy

x

x

equipmentBreakoutCap

EquipmentBreakoutCap

x

equipmentServerFeatureCap

EquipmentServerFeatureCap

x

extvmmNetworkSets

ExtvmmNetworkSets

x

extvmmVMNetworkSets

ExtvmmVMNetworkSets

x

fabricBreakout

FabricBreakout

x

fabricBreakoutOperation

FabricBreakoutOperation

x

x

x

x

fabricCabling

FabricCabling

x

fabricCablingSw

FabricCablingSw

x

fabricEthEstcEpOperation

FabricEthEstcEpOperation

x

x

x

x

fabricEthEstcPcEp

AppliancePortChannelMember

x

x

x

x

fabricEthEstcPcEpOperation

FabricEthEstcPcEpOperation

x

x

x

x

fabricEthEstcPcOperation

FabricEthEstcPcOperation

x

x

x

x

fabricEthLanPcEp

UplinkPortChannelMember

x

x

x

x

fabricEthLanPcEpOperation

FabricEthLanPcEpOperation

x

x

x

x

fabricEthLanPcOperation

FabricEthLanPcOperation

x

x

x

x

fabricEthTargetEp

Appliance

x

x

x

x

fabricEthTargetEpOperation

FabricEthTargetEpOperation

x

x

x

x

fabricEthVlanPc

VlanMemberPortChannel

x

x

x

x

fabricEthVlanPortEp

VlanMemberPort

x

x

x

x

fabricFcEstcEpOperation

FabricFcEstcEpOperation

x

x

x

x

fabricFcoeEstcEpOperation

FabricFcoeEstcEpOperation

x

x

x

x

fabricFcoeSanEpOperation

FabricFcoeSanEpOperation

x

x

x

x

fabricFcoeSanPcEp

FabricFcoeSanPcEp

x

fabricFcoeSanPcEpOperation

FabricFcoeSanPcEpOperation

x

x

x

x

fabricFcoeSanPcOperation

FabricFcoeSanPcOperation

x

x

x

x

fabricFcoeVsanPc

FabricFcoeVsanPc

x

x

x

fabricFcoeVsanPortEp

VsanMemberFcoePort

x

x

x

x

fabricFcSanEpOperation

FabricFcSanEpOperation

x

x

x

x

fabricFcSanPcEp

FabricFcSanPcEp

x

fabricFcSanPcEpOperation

FabricFcSanPcEpOperation

x

x

x

x

fabricFcSanPcOperation

FabricFcSanPcOperation

x

x

x

x

fabricFcUplinkOperation

FabricFcUplinkOperation

x

x

x

x

fabricFcVsanPc

VsanMemberFcPortChannel

x

x

x

x

fabricFcVsanPortEp

VsanMemberFcPort

x

x

x

x

fabricLanCloudPolicy

FabricLanCloudPolicy

x

x

fabricLanPinGroup

EthernetPinGroup

x

fabricLanPinGroupOperation

FabricLanPinGroupOperation

x

x

x

x

fabricLanPinTarget

EthernetPinGroupTarget

x

fabricLanPinTargetOperation

FabricLanPinTargetOperation

x

x

x

x

fabricSanPinGroup

FcPinGroup

x

fabricSanPinGroupOperation

FabricSanPinGroupOperation

x

x

x

x

fabricSanPinTarget

FcPinGroupTarget

x

fabricSanPinTargetOperation

FabricSanPinTargetOperation

x

x

x

x

fabricSwSubGroup

FabricSwSubGroup

x

fabricVlanEp

FabricVlanEp

x

fabricVsanEp

FabricVsanEp

x

fabricVsanMembership

FabricVsanMembership

x

firmwareAutoSyncPolicy

FirmwareAutoSyncPolicy

x

x

firmwareComponentSpec

FirmwareComponentSpec

x

firmwareExcludeServerComponent

FirmwareExcludeServerComponent

x

x

x

firmwareUpgradeDetail

FirmwareUpgradeDetail

x

firmwareUpgradeInfo

FirmwareUpgradeInfo

x

graphicsCard

GraphicsCard

x

graphicsController

GraphicsController

x

lsbootEmbeddedLocalDiskImage

LsbootEmbeddedLocalDiskImage

x

x

x

x

lsbootEmbeddedLocalDiskImagePath

LsbootEmbeddedLocalDiskImagePath

x

x

x

x

lsbootEmbeddedLocalLunImage

LsbootEmbeddedLocalLunImage

x

x

x

x

lsbootUEFIBootParam

LsbootUEFIBootParam

x

x

x

x

lsFcLocale

LsFcLocale

x

lsFcZone

LsFcZone

x

lsFcZoneGroup

LsFcZoneGroup

x

lsZoneInitiatorMember

LsZoneInitiatorMember

x

lsZoneTargetMember

LsZoneTargetMember

x

messageEntry

MessageEntry

x

mgmtInbandProfile

MgmtInbandProfile

x

x

policyEquipment

PolicyEquipment

x

policyPortConfig

PolicyPortConfig

x

powerChassisMember

PowerChassisMember

x

x

x

powerEp

PowerEp

x

qosclassDefinition

QosclassDefinition

x

x

qosclassEthBE

BestEffortQosClass

x

x

qosclassEthClassified

QosClass

x

x

qosclassFc

FcQosClass

x

x

securityUnit

SecurityUnit

x

smartcallhomeHttpProxy

SmartcallhomeHttpProxy

x

x

x

x

smartcallhomePeriodicInventoryStatus

SmartcallhomePeriodicInventoryStatus

x

smartcallhomePeriodicSystemInventory

SmartcallhomePeriodicSystemInventory

x

x

smartcallhomePolicy

SmartcallhomePolicy

x

x

x

x

smartcallhomeProfile

SmartcallhomeProfile

x

smartcallhomeSource

SmartcallhomeSource

x

x

smartcallhomeTransportGateway

SmartcallhomeTransportGateway

x

x

x

x

smartlicenseEntitlement

SmartlicenseEntitlement

x

smartlicenseEntitlementEp

SmartlicenseEntitlementEp

x

smartlicenseEp

SmartlicenseEp

x

smartlicenseHolder

SmartlicenseHolder

x

storageReplicationCtx

StorageReplicationCtx

x

storageSnapshotCtx

StorageSnapshotCtx

x

topInfoSyncPolicy

TopInfoSyncPolicy

x

x

vnicIniGrpFc

VnicIniGrpFc

x

vnicIniGrpFcIf

VnicIniGrpFcIf

x

vnicProfileSet

VnicProfileSet

x

vnicRackServerDiscoveryProfile

VnicRackServerDiscoveryProfile

x

x

Known Limitations and Behavioral Changes

Known Limitations and Behavioral Changes in 2.0(1)

The following are the known limitations in Release 2.0(1):

  • Sync-UcsCentralManagedObject cmdlet fails when sending an XML request for configuring the managed object of different providers

  • The output of ConvertTo-UcsCentralCmdlet fails if there is a managed object of different providers within a transaction

  • Executing Add-UcsCentralAaaDomainGroup without providing DomainGroupDn parameter value does not assign the domain group to the locale. Also, an empty record or a line is created in the assigned domain group's UI

Known Limitations and Behavioral Changes in 2.5(1)

32 Parameter Set Limitation

According to the Microsoft PowerShell framework, cmdlets cannot have more than 32 Parameter Sets. If the number of Parameter Sets for a cmdlet is more than 32, the cmdlet may not be able to identify the Parameters or Parameter Sets correctly, and may behave abnormally.

The following PowerTool cmdlets are affected by this limitation:

  • Get-UcsEquipmentFruVariant

  • Get-UcsEquipmentManufacturingDef

  • Get-UcsEquipmentPhysicalDef

  • Get-UcsEquipmentPicture

  • Get-UcsEquipmentServiceDef

  • Get-UcsEquipmentSlotArrayRef

  • Get-UcsFirmwareUpgradeConstraint

After a logical grouping of Parameter Sets is made, each cmdlet is split into two cmdlets. For each existing cmdlet, storage-related Parameter Sets are removed from the original cmdlet and made into a new cmdlet. This provides the following additional storage-related PowerTool cmdlets:

  • Get-UcsEquipmentFruVariantStorage

  • Get-UcsEquipmentManufacturingDefStorage

  • Get-UcsEquipmentPhysicalDefStorage

  • Get-UcsEquipmentPictureStorage

  • Get-UcsEquipmentServiceDefStorage

  • Get-UcsEquipmentSlotArrayRefStorage

  • Get-UcsFirmwareUpgradeConstraintStorage

Because storage-specific Parameter Sets now have their own cmdlets, backward compatibility may break while using the original cmdlets for storage-specific Parameter Sets.

Cisco recommends that you use the new storage cmdlets for the specified storage-related Parameter Sets.

Detailed information about the syntax for these cmdlets is available here.

Resolved Caveats

This section lists the resolved caveats for Cisco UCS PowerTool Suite:

Bug ID

Description

First Release Affected

Resolved in Release

CSCwf07507

Cannot copy firmware to 6400 Fabric Interconnects

3.0(4)

3.0.4.2

CSCvw69456

Start-UcsGuiSession cmdlet should show error message for UCSM above v3.1(3a)

3.0(1)

3.0(2)

CSCvv37504

UCS Central cmdlet Get-UcsCentralCapability is returning empty data for Memory Module Objects

3.0

3.0(1)

CSCvt68987

UCSCentral cmdLet for Add-UcsCentralTagSoftwareInst not working as desired

2.5(3)

3.0(1)

CSCvn85245

PowerTool refresh for released schema

3.0

3.0(1)

CSCve03633

Enhancements for IMC-Powertool User Guide.

2.0(3)

2.4(1)

CSCve45888

For UCS Central 1.5.(1b), UCS Central PoweTool 2.2(1) does not generate the cmdlets for the Service Profiles (SP) created from the Service Profile Templates when using Advance and Manual Entry for SP Naming convention.

2.2(1)

2.3(1)

CSCvc70423

Connections to Cisco IMC running 3.0(1) firmware fails from Cisco IMC PowerTool. The connection fails as the Cisco IMC 3.0(1) uses TLS 1.2 version which is not supported in the current version of the UCS PowerTool Suite.

2.0(1)

2.2(1)

CSCva02758

Get-UcsSoftwareImageList is unable to retrieve the list of images using the MdfId & SoftwareId parameter

2.0(1)

2.2(1)

CSCva01289

When using the Get-UcsSoftwareImage cmdlet to download some images, following error is displayed IMAGE_GUID_INVALID error

2.0(1)

2.1(1)

CSCuy44303

Send-UcsCentralFirmware fails with the following error:

The underlying connection was closed: The connection was closed unexpectedly

2.0(1)

2.1(1)

CSCuy11089

Get-UcsSoftwareImageList cmdlet is unable to retrieve the list of drivers for UCS Manager 3.1(1), although they are available for downloads from Cisco.com.

2.0(1)

2.0(2)

CSCux63129

Cisco UCS Manager PowerTool fails to launch.

1.5.3 and before

2.0(1)

CSCux63265

Cisco UcsCentral PowerTool fails to launch on some Operating Systems with the following error:

The Module '%CentralPowerTool InstallPath%Cisco UcsCentralPS%' could not be loaded

1.0(1)

2.0(1)

CSCux63164

Cisco IMC PowerTool fails to launch on some Operating Systems with the following error:

The Module '%ImcInstallPath %CiscoImcPS%' could not be loaded

1.4(1) and before

2.0(1)

Open Caveats

The following table lists the open caveats for Cisco UCS PowerTool Suite:

Bug ID

Symptom

Workaround

First Affected in Release

CSCup06986

Unable to bind argument to parameter error while running the script.

Remove the cmdlets causing this error from the script and rerun the script.

2.0(1)

CSCum26147

Cisco UCS E-Series GUI does not allow local user password fewer than seven characters. But the PowerTool cmdlets allows setting of one-character password.

Set minimum of seven character passwords, so that you can use the same password with the Cisco UCS E-Series GUI too.

2.0(1)

CSCuo95020

ParameterBindingValidation Exception error occurs on some cmdlets generated from the ConverTo cmdlet using backup file.

To resolve this issue, run the generated cmdlets after performing one of the following:

  • Remove cmdlets which cause this error

  • Provide the correct format for the affected parameter.

2.0(1)

Related Documentation

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see What’s New in Cisco Product Documentation at:http://www.cisco.com/c/en/us/td/docs/general/whatsnew/whatsnew.html

Subscribe to What’s New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSS feeds are a free service.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.