Release Notes for Cisco UCS Manager PowerTool, Release 1.x

Available Languages

Download Options

  • PDF     (313.2 KB)
    View with Adobe Reader on a variety of devices
  • ePub     (86.8 KB)
    View in various apps on iPhone, iPad, Android, Sony Reader, or Windows Phone
Updated:December 22, 2015

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Table of Contents

Release Notes for Cisco UCS Manager PowerTool, Release 1.x

Contents

Revision History

Introduction

System Requirements

Cisco UCS Manager

Windows PowerShell Requirements

Installation Requirements

New Features

New Features for Release 1.5.2

Key Features in Release 1.5.2

New Cmdlets for Release 1.5.2

New Feature for Release 1.5.1

Key Features in Release 1.5.1

New Cmdlets for Release 1.5.1

New Features for Release 1.4.1

Key Features in Release 1.4.1

New Cmdlets for Release 1.4.1

New Features for Release 1.3.1

Key Features in Release 1.3.1

New Cmdlets for Release 1.3.1

New Features for Release 1.2.1

Key Features in Release 1.2.1

New Cmdlets for Release 1.2.1

New Features for Release 1.1.2

New Features for Release 1.1.1

Key Features in Release 1.1.1

New Cmdlets for Release 1.1.1

New Features for Release for 1.0.1

Key Features in Release 1.0.1

New Features for Release 1.0

Key Features in Release 1.0

PowerShell Functionality

New Cmdlets

New Generated Cmdlets

New Functionality for Release 1.0

Known Limitations

Resolved Caveats

Open Caveats

Related Documentation

Obtaining Documentation and Submitting a Service Request

Release Notes for Cisco UCS Manager PowerTool, Release 1.x

First Published: January 2013

Revised Date: December 2015

Current Release: 1.x

 

This document describes the system requirements, new features, information about the images, resolved caveats, known caveats, and workarounds for Cisco UCS Manager PowerTool, Release 1.x. This document also includes current information that became available after the technical documentation was published.

Use these release notes as a supplement with the other documents listed in the documentation roadmap at http://www.cisco.com/go/unifiedcomputing/b-series-doc.

Make sure to review other available documentation on Cisco.com to obtain the most current information about Cisco UCS Manager PowerTool, Release 1.x

Contents

This document includes the following sections:

Revision History

Table 1 shows the revision history:

Table 1 Online History Changes

Revision
Release
Date
Description

A0

1.0

January 2013

Created Release notes for Cisco UCS Manager PowerTool, Release 1.0

B0

1.0.1

August 2013

Updated Release notes for Cisco UCS Manager PowerTool, Release 1.0.1

C0

1.1.1

March 2014

Following changes were made in this revision:

  • Updated the Cisco UCS Manager section.
  • Updated the New Features section.
  • Added the Known Issues section.

D0

1.1.2

May 2014

Following changes were made in this revision:

  • Updated New Features section with information on Release 1.1.2.

E0

1.2.1

July 2014

Following changes were made in this revision:

  • Updated New Features section with information on Release 1.2.1

F0

1.3.1

November 2014

Following changes were made in this revision:

  • Updated New Features section with information on Release 1.3.1
  • Added Release 3.0 to the Cisco UCS Manager section.
  • Added a new section Limitations of Using PowerTool With Cisco UCS Manager Release 3.0(1) for UCS Mini.

G0

1.4.1

April 2015

Following change is made in this revision:

  • Updated New Features section with information on Release 1.4.1

H0

1.5.1

July 2015

Following changes is made in this revision:

  • Updated New Features section with information on Release 1.5.1

I0

1.5.2

November 2015

Following change is made in this revision:

  • Updated New Features section with information on Release 1.5.2

J0

1.5.3

December 2015

Following changes are made in this revision:

  • Updated Open Caveats and Resolved Caveats sections

Introduction

Cisco UCS Manager PowerTool is a PowerShell module that helps automate all aspects of Cisco UCS Manager including server, network, storage, and hypervisor management. Cisco UCS Manager PowerTool enables easy integration with existing IT management processes and tools. The PowerTool cmdlets work on the Cisco UCS Manager’s Management Information Tree (MIT). This release contains more than 1800 cmdlets. These cmdlets can be used to execute read, create, modify, and delete operations on all the UCS Manager Managed Objects (MOs) in the MIT.

System Requirements

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

  • Windows PowerShell 2.0 or above must be installed on the system
  • .NET Framework Version 2.0 SP1 (or later)

Cisco UCS Manager

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

  • Release 3.0
  • Release 2.5
  • Release 2.2
  • Release 2.1
  • Release 2.0

Windows PowerShell Requirements

Cisco UCS Manager PowerTool supports Windows PowerShell 2.0 and later.

Installation Requirements

Before installing Cisco UCS Manager PowerTool, do the following:

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

New Features

New Features for Release 1.5.2

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

Key Features in Release 1.5.2

  • Support for new features in UCS Manager Release 2.2(6) and 2.5(2)
  • Support for XML and Force flags in server operations cmdlets introduced in PowerTool 1.5.1

New Cmdlets for Release 1.5.2

Managed Object (MO)
PowerShell Nouns
Get
Add
Set
Remove

equipmentStorageSasExpanderCapProvider

EquipmentStorageSasExpanderCapProvider

x

 

 

 

equipmentStorageSasExpanderCapRef

EquipmentStorageSasExpanderCapRef

x

 

 

 

New Feature for Release 1.5.1

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

Key Features in Release 1.5.1

Server Operations
Cmdlets

Acknowledge UCS Server

Confirm-UcsServer

Decommission UCS Server

Disable-UcsServer

Hard Reset UCS Server

Reset-UcsServer

Booting UCS Server

Start-UcsServer

Shutting down UCS Server

Stop-UcsServer

Power Cycling UCS Server

Restart-UcsServer

Resetting CMOS for a UCS Server

Reset-UcsServerCmos

Resetting BMC for a UCS Server

Reset-UcsServerBmc

Turn On Locator LED for a UCS Server

Enable-UcsLocatorLed

Turn Off Locator LED for a UCS Server

Disable-UcsLocatorLed

New Cmdlets for Release 1.5.1

Managed Object (MO)
PowerShell Nouns
Get
Add
Set
Remove

adaptorMgmtVnicEthConfig

AdaptorMgmtVnicEthConfig

 

 

 

 

adaptorRnicCapSpec

AdaptorRnicCapSpec

x

 

 

 

biosVfConsistentDeviceNameControl

BiosVfConsistentDeviceNameControl

x

x

 

 

biosVfIntelTrustedExecutionTechnology

BiosVfIntelTrustedExecutionTechnology

x

x

 

 

biosVfPCILOMPortsConfiguration

BiosVfPCILOMPortsConfiguration

x

x

 

 

biosVfTPMPendingOperation

BiosVfTPMPendingOperation

x

x

 

 

biosVfTrustedPlatformModule

BiosVfTrustedPlatformModule

x

x

 

 

equipmentBladeCapProviderTypeDef

EquipmentBladeCapProviderTypeDef

x

 

 

 

equipmentLocalDiskControllerTypeDef

EquipmentLocalDiskControllerTypeDef

x

 

 

 

lsIdentityInfo

LsIdentityInfo

x

 

 

 

lsbootUEFIBootParam

LsbootUEFIBootParam

x

x

x

x

networkLldpNeighborEntry

NetworkLldpNeighborEntry

x

 

 

 

networkLldpNeighbors

NetworkLldpNeighbors

x

 

 

 

equipmentStorageControllerConfig

EquipmentStorageControllerConfig

x

 

 

 

New Features for Release 1.4.1

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

Key Features in Release 1.4.1

  • Added new cmdlets for features in UCS Manager releases 2.5(1), 3.0(1), 3.0(2). For more information, see New Cmdlets for Release 1.4.1.
  • Support for new UCS M-Series Modular servers
  • Added Update-UcsCatalogue cmdlet to update the capability catalog from a local file source
  • Added Get-UcsServer cmdlet to get all the servers regardless of its form factor

New Cmdlets for Release 1.4.1

Managed Object (MO)
PowerShell Nouns
Get
Add
Set
Remove

adaptorHostScsiIf

AdaptorHostScsiIf

x

 

 

 

adaptorHostScsiLunRef

AdaptorHostScsiLunRef

x

 

 

 

adaptorUplinkPortStats

AdaptorUplinkPortStats

x

 

 

 

biosVfASPMSupport

BiosVfASPMSupport

x

 

x

 

biosVfCPUPowerManagement

BiosVfCPUPowerManagement

x

 

 

 

biosVfDDR3VoltageSelection

BiosVfDDR3VoltageSelection

x

 

x

 

biosVfEnhancedPowerCappingSupport

BiosVfEnhancedPowerCappingSupport

x

 

x

 

biosVfPCHSATAMode

BiosVfPCHSATAMode

x

 

x

 

biosVfQPISnoopMode

BiosVfQPISnoopMode

x

 

x

 

computeCartridge

Cartridge

x

 

x

 

computeInstanceIdQual

ComputeInstanceIdQual

x

x

 

x

computePooledEnclosureComputeSlot

ComputePooledEnclosureComputeSlot

x

x

 

x

computeServerUnit

ServerUnit

x

 

x

 

equipmentPowerCapDef

EquipmentPowerCapDef

x

 

 

 

equipmentServerUnitCapProvider

EquipmentServerUnitCapProvider

x

 

 

 

equipmentSharedIOModule

SharedIom

x

 

x

 

equipmentStorageLimitCap

EquipmentStorageLimitCap

x

 

 

 

fabricCartridgePhEp

FabricCartridgePhEp

x

 

x

 

fabricCartridgeSlotEp

FabricCartridgeSlotEp

x

 

x

 

fabricComputeMSlotEp

FabricComputeMSlotEp

x

 

x

 

fabricSubGroup

FabricSubGroup

x

x

 

 

lsbootLocalDiskImage

LsbootLocalDiskImage

x

x

x

x

lsbootLocalDiskImagePath

LsbootLocalDiskImagePath

x

x

x

x

lsbootLocalLunImagePath

LsbootLocalLunImagePath

x

x

x

x

lstorageDasScsiLun

LogicalStorageDasScsiLun

x

x

x

x

lstorageDiskGroupConfigDef

LogicalStorageDiskGroupConfigDef

x

 

 

 

lstorageDiskGroupConfigPolicy

LogicalStorageDiskGroupConfigPolicy

x

x

x

x

lstorageDiskGroupQualifier

LogicalStorageDiskGroupQualifier

x

x

x

x

lstorageLocalDiskConfigRef

LogicalStorageLocalDiskConfigRef

x

x

x

x

lstorageProfile

LogicalStorageProfile

x

x

x

x

lstorageProfileBinding

LogicalStorageProfileBinding

x

x

x

x

lstorageProfileDef

LogicalStorageProfileDef

x

x

x

x

lstorageVirtualDriveDef

LogicalStorageVirtualDriveDef

x

 

x

 

powerProfiledPower

PowerProfiledPower

x

 

 

 

storageVDMemberEp

StorageVDMemberEp

x

 

 

 

storageVirtualDriveRef

StorageVirtualDriveRef

x

 

 

 

New Features for Release 1.3.1

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

Key Features in Release 1.3.1

This release contains the following changes:

  • Added new cmdlets for features in UCS Manager release 2.2(3a). For more information, see New Cmdlets for Release 1.3.1
  • Support for Cisco UCS Manager, Release 3.0(1) for UCS Mini.
  • Start-UcsGuiSession cmdlet is modified to support the -Credential parameter. Using this parameter you can store the credential in a variable and pass it to a cmdlet.

New Cmdlets for Release 1.3.1

Managed Object (MO)
PowerShell Nouns
Get
Add
Set
Remove

adaptorEthNVGREProfile

AdaptorEthNVGREProfile

x

 

x

 

adaptorEthRoCEProfile

AdaptorEthRoCEProfile

x

 

x

 

adaptorEthVxLANProfile

AdaptorEthVxLANProfile

x

 

x

 

adaptorHostPort

AdaptorHostPort

x

 

 

 

adaptorHostPortCap

AdaptorHostPortCap

x

 

 

 

biosVfAltitude

BiosVfAltitude

x

 

x

 

biosVfTPMSupport

BiosVfTPMSupport

x

 

x

 

biosVfUSBConfiguration

BiosVfUSBConfiguration

x

 

x

 

equipmentUuidFeatureCap

EquipmentUuidFeatureCap

x

 

 

 

etherNiErrStats

EtherNiErrStats

x

 

 

 

etherNiErrStatsHist

EtherNiErrStatsHist

x

 

 

 

firmwareImageLock

FirmwareImageLock

x

 

 

 

mgmtCimcSecureBoot

MgmtCimcSecureBoot

x

 

x

 

networkLanNeighborEntry

NetworkLanNeighborEntry

x

 

 

 

networkLanNeighbors

NetworkLanNeighbors

x

 

 

 

networkSanNeighborEntry

NetworkSanNeighborEntry

x

 

 

 

networkSanNeighbors

NetworkSanNeighbors

x

 

x

 

policyIdResolvePolicy

PolicyIdResolvePolicy

x

 

x

 

topInfoPolicy

TopInfoPolicy

x

 

 

 

New Features for Release 1.2.1

This section briefly describes the new features introduced in Cisco UCS Manager PowerToolUCS Manager PowerTool, Release 1.2.1. For detailed information about the features listed, see the documents listed in the “Related Documentation“section.

Key Features in Release 1.2.1

This release contains the following changes:

  • Added new cmdlets for features in UCS Manager release 2.2(2). For more information, see New Cmdlets for Release 1.2.1.
  • Installer enhancement, removes dependency on batch file. You can now use the shortcut file to launch a module. Title bar shows version of PowerTool and few sample cmdlets are displayed on launch screen for your ease.
  • The cmdlet Get-UcsPowerToolCommunity launches the following Cisco UCS integrations community URL in a default web browser: http://communities.cisco.com/ucsintegrations
  • The ConvertTo-UcsCmdlet is modified for pipeline support. You can pass a managed object through a pipe and the ConvertTo-UcsCmdlet generates corresponding cmdlets.

New Cmdlets for Release 1.2.1

Managed Object (MO)
PowerShell Nouns
Get
Add
Set
Remove

adaptorEthArfsProfile

AdaptorEthArfsProfile

x

 

x

 

adaptorHostServiceEthIf

AdaptorHostServiceEthIf

x

 

x

 

biosVfAllUSBDevices

BiosVfAllUSBDevices

x

 

x

 

biosVfDRAMClockThrottling

BiosVfDRAMClockThrottling

x

 

x

 

biosVfFRB2Timer

BiosVfFRB2Timer

x

 

x

 

biosVfFrequencyFloorOverride

BiosVfFrequencyFloorOverride

x

 

x

 

biosVfInterleaveConfiguration

BiosVfInterleaveConfiguration

x

 

x

 

biosVfLOMPortsConfiguration

BiosVfLOMPortsConfiguration

x

 

x

 

biosVfPCISlotLinkSpeed

BiosVfPCISlotLinkSpeed

x

 

x

 

biosVfProcessorEnergyConfiguration

BiosVfProcessorEnergyConfiguration

x

 

x

 

biosVfProcessorPrefetchConfig

BiosVfProcessorPrefetchConfig

x

 

x

 

biosVfPSTATECoordination

BiosVfPSTATECoordination

x

 

x

 

biosVfQPILinkFrequencySelect

BiosVfQPILinkFrequencySelect

x

 

x

 

biosVfScrubPolicies

BiosVfScrubPolicies

x

 

x

 

biosVfUSBPortConfiguration

BiosVfUSBPortConfiguration

x

 

x

 

biosVfVGAPriority

BiosVfVGAPriority

x

 

x

 

cimcvmediaActualMountEntry

CimcvmediaActualMountEntry

x

 

 

 

cimcvmediaActualMountList

CimcvmediaActualMountList

x

 

 

 

cimcvmediaConfigMountEntry

VmediaMountEntry

x

x

x

x

cimcvmediaExtMgmtRuleEntry

CimcvmediaExtMgmtRuleEntry

x

 

 

 

cimcvmediaMountConfigDef

VmediaDefinition

x

x

x

x

cimcvmediaMountConfigPolicy

VmediaPolicy

x

x

x

x

computeBoardConnector

ComputeBoardConnector

x

 

 

 

computeExtBoard

ComputeExtBoard

x

 

 

 

computeKvmMgmtPolicy

ComputeKvmMgmtPolicy

x

x

x

x

dcxFcoeVifEp

DcxFcoeVifEp

x

 

 

 

equipmentBladeAggregationCapRef

EquipmentBladeAggregationCapRef

x

 

 

 

equipmentCimcVmedia

EquipmentCimcVmedia

x

 

 

 

equipmentFlashLife

EquipmentFlashLife

x

 

 

 

equipmentKvmMgmtCap

EquipmentKvmMgmtCap

x

 

 

 

equipmentPhysDevicesPerBoard

EquipmentPhysDevicesPerBoard

x

 

 

 

fabricLacpPolicy

FabricLacpPolicy

x

x

x

x

firmwareUcscInfo

FirmwareUcscInfo

x

 

 

 

mgmtBackupExportExtPolicy

MgmtBackupExportExtPolicy

x

 

x

 

mgmtBackupPolicyConfig

MgmtBackupPolicyConfig

x

 

 

 

storageMezzFlashLife

StorageMezzFlashLife

x

 

 

 

sysdebugLogExportPolicy

SysdebugLogExportPolicy

x

 

x

 

sysdebugLogExportStatus

SysdebugLogExportStatus

x

 

 

 

New Features for Release 1.1.2

This release contains the following changes:

  • No confirmation message when all cmdlets within transaction has a force flag
  • Convertto-UcsCmdlet does not generate empty parameter values in -XtraProperty, empty values are generated as regular parameter or value
  • The Get-Module -Name CiscoUcsPs cmdlet now shows the correct PowerTool version.
  • No prompt appears for generic set or remove cmdlets if they are in a transaction.
  • Convertto-UcsCmdlet generates Dn for generic Add cmdlet as it is a mandatory parameter
  • Support for the following cmdlets:

– Get-UcsFabricEthLinkProfile

– Set-UcsVnicIScsiBootParams

– Add-UcsAaaEpUser/Remove-UcsAaaEpUser

– Set-UcsIom

  • No need to pass the UcsHandle for Import-UcsMoXml cmdlet
  • Compare-UcsManagedObject cmdlet skips auto created MO's
  • Convertto-UcsCmdlet validates property having empty value before generation

New Features for Release 1.1.1

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

Key Features in Release 1.1.1

Cisco UCS Manager PowerTool, Release 1.1.1, includes the following new key features:

– Allows connectivity to UCS Manager using IPv6 addresses.

– Allows access to external facing client applications, such as scp, ftp, tftp, ntp, dns, and so on. Also, allow acces to external facing services, such as sshd, httpd, snmpd, and so on, over IPv6 addresses.

  • Start-UcsGuiSession can now handle UcsHandle/UcsStatus as pipeline inputs. If there is no connection to the UCS, start the GUI by providing the UCS Manager IP or name as a parameter to the Start-UCSGuiSession cmdlet. If there is a connection to the UCS, no credentials are required. The cmdlet generates a token and uses it.
  • Some auto generated Managed Objects (MO) executed with errors while performing a compare or Sync on UCS MOs. The cmdlet is modified to resolve these issues in this release.
  • When multiple Set or Remove cmdlets were being used in a transaction, prompting for individual cmdlets failed to occur. This issue has been fixed and now you get prompts for each cmdlet.

New Cmdlets for Release 1.1.1

Managed Object (MO)
PowerShell Nouns
Get
Add
Set
Remove

equipmentAdvancedBootOrder

UcsEquipmentAdvancedBootOrder

x

 

 

 

equipmentSecureBoot

UcsEquipmentSecureBoot

x

 

 

 

equipmentTpm

UcsEquipmentTpm

x

 

 

 

equipmentTpmCapProvider

UcsEquipmentTpmCapProvider

x

 

 

 

mgmtIPv6IfConfig

UcsMgmtIPv6IfConfig

x

 

 

 

mgmtProfDerivedInterface

UcsMgmtProfDerivedInterface

x

 

 

 

storageFlexFlashCard

UcsStorageFlexFlashCard

x

 

 

 

storageFlexFlashController

UcsStorageFlexFlashController

x

 

 

 

storageFlexFlashDrive

UcsStorageFlexFlashDrive

x

 

 

 

storageFlexFlashVirtualDrive

UcsStorageFlexFlashVirtualDrive

x

 

 

 

extvmmFNDReference

UcsNetworkSiteReference

x

 

 

 

extvmmVMNDRef

UcsNetworkSegmentReference

x

x

 

x

ippoolIpV6Block

UcsIppoolIpV6Block

x

x

 

x

vnicUsnicConPolicyRef

UcsVnicUsnicConPolicyRef

x

x

 

x

vnicVmqConPolicyRef

UcsVnicVmqConPolicyRef

x

x

 

x

computeFwSyncAck

UcsComputeFwSyncAck

x

 

x

 

computeMemoryConfigPolicy

UcsComputeMemoryConfigPolicy

x

 

x

 

computeMemoryConfiguration

UcsComputeMemoryConfiguration

x

 

x

 

extmgmtNdiscTargets

UcsExtmgmtNdiscTargets

x

 

x

 

firmwareAutoSyncPolicy

UcsFirmwareAutoSyncPolicy

x

 

x

 

mgmtIPv6IfAddr

UcsMgmtIPv6IfAddr

x

 

x

 

mgmtInbandProfile

UcsMgmtInbandProfile

x

 

x

 

extvmmFabricNetwork

UcsFabricNetwork

x

x

x

x

extvmmFabricNetworkDefinition

UcsNetworkSite

x

x

x

x

extvmmUpLinkPP

UcsUpLinkPortProfile

x

x

x

x

extvmmVMNetwork

UcsVmNetwork

x

x

x

x

extvmmVMNetworkDefinition

UcsNetworkSegment

x

x

x

x

fabricUdldLinkPolicy

UcsFabricUdldLinkPolicy

x

x

x

x

ipDnsSuffix

UcsIpDnsSuffix

x

x

x

x

ipIPv4WinsServer

UcsIpIPv4WinsServer

x

x

x

x

lsbootBootSecurity

UcsLsbootBootSecurity

x

x

x

x

lsbootDefaultLocalImage

UcsLsbootDefaultLocalImage

x

x

x

x

lsbootLocalHddImage

UcsLsbootLocalHddImage

x

x

x

x

lsbootSan

UcsLsbootSan

x

x

x

x

lsbootSanCatSanImage

UcsLsbootSanCatSanImage

x

x

x

x

lsbootSanCatSanImagePath

UcsLsbootSanCatSanImagePath

x

x

x

x

lsbootUsbExternalImage

UcsLsbootUsbExternalImage

x

x

x

x

lsbootUsbFlashStorageImage

UcsLsbootUsbFlashStorageImage

x

x

x

x

lsbootUsbInternalImage

UcsLsbootUsbInternalImage

x

x

x

x

mgmtInterface

UcsMgmtInterface

x

x

x

x

mgmtVnet

UcsMgmtVnet

x

x

x

x

vnicIpV6MgmtPooledAddr

UcsVnicIpV6MgmtPooledAddr

x

x

x

x

vnicIpV6StaticAddr

UcsVnicIpV6StaticAddr

x

x

x

x

vnicUsnicConPolicy

UcsVnicUsnicConPolicy

x

x

x

x

vnicVmqConPolicy

UcsVnicVmqConPolicy

x

x

x

x

vnicIpV4MgmtPooledAddr

UcsVnicIpV4MgmtPooledAddr

x

x

x

x

New Features for Release for 1.0.1

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

Key Features in Release 1.0.1

Cisco UCS Manager PowerTool, Release 1.0.1, includes the following new key features:

  • Support for generating PowerTool cmdlets for the configuration present in the UCS Backup.xml file. For example, ConvertTo-UcsCmdlet -UcsBackup -Path C:\backup.xml -OutputPath C:\PowerToolScript.txt.
  • Support for storing jnlp file and enable logging when using Start-UcsGuiSession cdmlets. For example, Start-UcsGuiSession -LogAllXml.

New Features for Release 1.0

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

Key Features in Release 1.0

Cisco UCS Manager PowerTool, Release 1.0, includes the following new key features:

  • Stateful connection management to multiple Cisco UCS Manager systems in parallel
  • Firmware upgrade support
  • Support for creating and downloading technical support information
  • Support for backing up Cisco UCS Manager configuration
  • Support for importing Cisco UCS Manager configuration
  • Support for launching a GUI session of Cisco UCS Manager from PowerTool
  • Support for launching a KVM session of a server from PowerTool
  • Support for monitoring an event stream of Cisco UCS Manager
  • Support for comparing and synchronizing configurations within or between Cisco UCS Manager sessions
  • Support for generating PowerTool cmdlets automatically when performing the equivalent operation on Cisco UCS Manager GUI (ConvertTo-UcsCmdlet)
  • Support for transactions
  • Support for registration of Cisco UCS Manager with Cisco UCS Central
  • Service profile management (create/modify/delete/associate)
  • Log viewing and management
  • Server power management
  • Full inventory management
  • Raw XML input and output capability

PowerShell Functionality

Cisco UCS Manager PowerTool, Release 1.0 includes the following PowerShell functionality:

  • Fully object based
  • Command pipelining support
  • Inline help (get-help) support
  • Standard verb implementation

New Cmdlets

Cisco UCS Manager PowerTool, Release 1.0, includes the following new cmdlets:

  • Register-UcsCentral—Registers a Cisco UCS domain with Cisco UCS Central.
  • Unregister-UcsCentral—Unregisters a Cisco UCS domain with Cisco UCS Central.
  • Rename-UcsServiceProfile—Renames a service profile.
  • Export-UcsMoXml—Exports Managed Object XML.
  • Import-UcsMoXml—Imports XML and converts into objects.

New Generated Cmdlets

Cisco UCS Manager PowerTool, Release 1.0, includes 184 new cmdlets from Cisco UCS Manager, Release 2.1 Schema.

New Functionality for Release 1.0

Cisco UCS Manager PowerTool, Release 1.0 includes the following enhancements:

  • Added support for configConfRename in ConvertTo-UcsCmdlet.
  • Ability to fetch all naming property values from RN in case they are not available in XML in ConvertTo-UcsCmdlet.
  • Modified ConvertTo-UcsCmdlet to put properties having value null in –XtraProperties.
  • Added support for input parameter regex validation.
  • Added a missing verb set for VnicIPv4PooledIscsiAddr.

Known Limitations

This section lists the known limitation for Cisco UCS Manager PowerTool

  • On launching UCS Manager HTML 5 GUI, no logs are created. Therefore, Convertto cmdlet does not work.
  • Limitations of Using PowerTool, Release 1.3(1) With Cisco UCS Manager Release 3.0(1) for UCS Mini

Cisco UCS Manager PowerTool release 1.3.1 can be used to automate tasks for managing the Cisco UCS Mini platform. However, it does not have cmdlets for the following Managed Objects introduced for Cisco UCS Fabric Interconnect 6324 in Cisco UCS Manager, Release 3.0(1) for UCS Mini:

– equipmentBladeSwitchConnDef

– equipmentPortCap

– equipmentPowerCapDef

– equipmentSwitchIOCard

– equipmentSwitchIOCardCapProvider

– equipmentSwitchTypeDef

– fabricSubGroup

– fabricSwSubGroup

– featureContextEp

– featureDefinition

– featureDefinitionInstance

– featureDefinitionRef

– featureFruCapProviderInstance

– featureFruCapProviderRef

– featureProvider

– featureProviderInstance

– firmwareImageLock

– firmwarePlatformBundleTypeCapProvider

– firmwareUcscInfo

– iqnpoolTransportBlock

– portSubGroup

– powerProfiledPower

– swSubGroup

You can use generic cmdlets: Get-UcsManagedObject and Set-UcsManagedObject to manage these objects.

Resolved Caveats

This section lists the resolved caveats for UCS Manager PowerTool.

Table 2 Resolved Caveats

Bug ID
Description
First Release Affected
Resolved in Release

CSCux41733

The ConvertTo-UcsCmdlet does not work on Windows 10 when the parameters are set to default

1.5(2) and before

1.5(3)

CSCuq76318

Fixed issues with the Get-UcsCcoImageList cmdlet. The value was either too large or too small for a UInt32.

1.2(1)

1.3(1)

CSCun01525

Fix for the Java 7 Update 45 issue with UCS Manager GUI results in breaking the cmdlet generation while using the ConvertTo-UcsCmdlet.

1.1(1)

1.2(1)

CSCuh42325

PowerTool Notes - links to middle of User Guide (and not top)

1.0(1)

1.2(1)

CSCuh26843

Add missing verb for generated cmdlet (Set for ExtmgmtMiiStatus, Get or Set for FabricFcoeVsanPc, Add for lsVConAssign)

1.0(1)

1.1(1)

CSCuh42317

User Guide does not mention Start-UcsGuiSession

1.0

1.0(1)

Open Caveats

Open caveat is provided in the following release-specific table:

Open caveats may be listed in association with the release in which they were first noticed or in the release identified as the first affected. We recommend to review open caveats in all releases to avoid overlooking a defect that may impact their release.

The following caveat is open in Release 1.5(3):

Table 3 Open Caveat in Release 1.5(3)

Defect ID
Symptom
Workaround
First Bundle Affected

CSCux63129

On some operating systems Cisco UCS Manager PowerTool fails to launch and throws the following error:

"The Module '%PowerToolInstallPath%CiscoUcsPS% could not be loaded”

Reboot or Log-off after installing Cisco UCS Manager PowerTool to update the environment variables.

1.5(3) and before

The following caveat is open in Release 1.4(1):

 

Table 4 Open Caveat in Release 1.4(1)

Defect ID
Symptom
Workaround
First Bundle Affected

CSCut84285

Get-UcsCcoImageList cmdlet does not display the list of all the images for Cisco UCS M-Series servers

Download the required images manually from Cisco.com for Cisco UCS M-Series servers.

1.4(1)

Related Documentation

For more information, you can access related documents from the following links:

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/en/US/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.

This document is to be used in conjunction with the documents listed in the “Related Documentation” section.

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 and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2015 Cisco Systems, Inc. All rights reserved.

Was this Document Helpful?

FeedbackFeedback

Contact Cisco

This Document Applies to These Products