目次

• Cisco UCS Director PowerShell コンソールの開始
• このリリースの新規情報および変更情報
• Cisco UCS Director PowerShell コンソール
• インストールと設定
• システム要件
• Windows PowerShell バージョンの決定
• Cisco UCS Director PowerShell コンソールの確認
• Cisco UCS Director PowerShell コンソールの設定
• コマンドレットの操作
• コマンドレット リスト
• コマンドレット向けヘルプ
• コマンドレットの入力定義
• コマンドレットの出力タイプ
• レポート表示のコマンドレット
• 例：Help コマンドを使用したコマンドレットのパラメータの取得
• 例：コマンドレット出力のキャプチャとフィルタリング
• 例：表形式レポートの表示
• 例：サービス リクエストのキャンセル
• トラブルシューティング
• 接続例外エラー
• 実行中のスクリプトが無効
• コマンドレットの実行に失敗

First Published: September 16, 2016

Cisco UCS Director PowerShell コンソールの開始

---

このリリースの新規情報および変更情報

このガイドでは、新しいリリースに関する大幅な変更は行われていません。

Cisco UCS Director PowerShell コンソール

Cisco UCS Director が提供する JSON ベースの REST API では、ワークフロー要求の送信、ワークフロー入出力スキーマの検査、およびレポートの取得を実行できます。データセンター管理の自動化を向上させるために、Cisco UCS Director API を Cisco UCS Director PowerShell コンソールに統合できます。

Cisco UCS Director PowerShell コンソールによって、JSON ベースの API 用のコマンドレット ラッパーが提供されます。各コマンドレットは単一操作を実行します。コマンドレットは Microsoft Windows サーバで実行されます。JSON ベースの API によって返されるデータに応じて、コマンドレットは自動的にデータを解釈し、Windows PowerShell オブジェクトに変換します。複数のコマンドレットを 1 つに連結できます。使用可能なコマンドレットのリストを表示するには、コマンドレット リスト を参照してください。REST API の詳細については、『Cisco UCS Director REST API Getting Started Guide』を参照してください。

PowerShell コンソールは PowerShell エージェントとは異なります。PowerShell コンソールによって、JSON ベースの API 用のコマンドレット ラッパーが提供されます。PowerShell エージェントは、Cisco UCS Director と Microsoft System Center Virtual Machine Manager（SCVMM）の間のインターフェイスであり、インベントリ収集やその他の管理機能に関与します。

インストールと設定

システム要件

Windows PowerShell は、.NET Framework 共通言語ランタイム（CLR）と .NET Framework をベースに作成されています。これは .NET Framework オブジェクトを受け入れて、返します。

PowerShell を操作するには、次のものをサポートする任意の Windows ベースのシステムに Cisco UCS Director PowerShell コンソールをインストールする必要があります。

• .NET Framework 4.0 以降

• Windows PowerShell バージョン 3.0 または 4.0

Windows PowerShell バージョンの決定

システムで実行されている Windows PowerShell バージョンの情報を表示するには、$PSVersionTable コマンドを使用します。

次のコンソール出力は、$PSVersionTable コマンドの例です。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> $PSVersionTable

Name                       Value
----                       -----
PSVersion                  4.0
WSManStackVersion          3.0
SerializationVersion       1.1.0.1
CLRVersion                 4.0.30319.34209
BuildVersion               6.3.9600.16406
PSCompatibleVersions       {1.0, 2.0, 3.0, 4.0}
PSRemotingProtocolVersion  2.2


PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>

Cisco UCS Director PowerShell コンソールの確認

Cisco UCS Director PowerShell コンソールが正しくインストールされたことを確認するには、Get-Module コマンドを使用します。

Get-Module コマンドを使用すると、次のようにモジュールのタイプ、バージョン、および名前が表示されます。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Get-Module

ModuleType   Version   Name                     ExportedCommands
----------   -------   ----                     ---------------
Binary       5.4.0.0   CiscoUcsdPS              {Invoke-userAPICan...


PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>

 

モジュールの名前を取得した後のバージョンのみを確認するには、次に示すようなコマンドを使用します。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> (Get-Module CiscoUcsdPS).version

Major Minor Build Revision
----- ----- ----- --------
5     4     0     0

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>

 

（注）	前の 2 つの例では、バージョン 5.4.0.0 になる予定のインストール済み Cisco UCS Director PowerShell コンソールを示しています。異なるバージョンをインストールしている場合は、バージョン番号が異なる場合があります。たとえば、新しいバージョンにアップグレードしている場合などです。

Cisco UCS Director PowerShell コンソールの設定

コマンドレットを Cisco UCS Director サーバに対して実行するには、PowerShell コンソールで環境変数を設定する必要があります。すべてのコマンドレットは、Cisco UCS Director の IP アドレスおよび REST キーをオプション パラメータとして受け入れます。これらのパラメータを指定しない場合、コマンドレットは PowerShell 環境変数 UCSD_SERVER および UCSD_RESTKEY から選択します。

環境変数は、以下のように SetEnvironmentVariable メソッドを使用して設定できます。

[Environment]::SetEnvironmentVariable("UCSD_SERVER","10.1.1.1","User")

[Environment]::SetEnvironmentVariable("UCSD_RESTKEY","562FDF763A384E78B9BAB7FE02CA13B6","User")

設定済みの環境変数を取得するには、次のように GetEnvironmentVariable コマンドを使用します。

[Environment]::GetEnvironmentVariable("UCSD_RESTKEY","User")

（注）	環境変数の変更を有効にするには、PowerShell コンソールを閉じてから再度開きます。

コマンドレットの操作

コマンドレット リスト

Get-Command を使用して、使用可能なコマンドレットのリストを表示できます。

次のコマンドレットのリストは、Get-Command を使用して取得されました。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Get-Command -Module CiscoUcsdPS

CommandType   Name                                               ModuleName
----------    ----                                               ----------
Cmdlet        Invoke-UserAPICancelSeviceRequest                  CiscoUcsdPS
Cmdlet        Invoke-UserAPIExecuteVMAction                      CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetAllCatalogs                       CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetAllGroups                         CiscoUcsdPS
Cmdlet        Invoke-userAPIGetAllVDCs                           CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetAvailableReports                  CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetHistoricalReport   	              CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetInstantDataReport                 CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetPage                              CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetSeviceRequestDetails              CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetSeviceRequests                    CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetSeviceRequestWorkflow             CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetTabularReport                     CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetVMActionRequests                  CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetWorkflowInputs                    CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetWorkflowInputValue                CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetWorkflowInputValues               CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetWorkflows                         CiscoUcsdPS
Cmdlet        Invoke-UserAPIGetWorkflowStatus                    CiscoUcsdPS
Cmdlet        Invoke-UserAPIReconfigureVM                        CiscoUcsdPS
Cmdlet        Invoke-UserAPIRollbackflow                         CiscoUcsdPS
Cmdlet        Invoke-UserAPISubmitServiceRequest                 CiscoUcsdPS
Cmdlet        Invoke-UserAPISubmitServiceRequestCustom           CiscoUcsdPS
Cmdlet        Invoke-UserAPISubmitWorkflowServiceRequest         CiscoUcsdPS
Cmdlet        Invoke-UserAPISubmitWorkflowServiceRequestWithG... CiscoUcsdPS
Cmdlet        Invoke-UserAPISubmitWorkflowServiceRequestWithS... CiscoUcsdPS
Cmdlet        Invoke-UserAPIValidateWorkflow                     CiscoUcsdPS
Cmdlet        Invoke-UserAPIWorkflowInputDetails                 CiscoUcsdPS


PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>

コマンドレット向けヘルプ

コマンドレットは、Cisco UCS Director PowerShell コンソールで実行できます。コマンドレットのヘルプを表示するには、? または get-Help コマンドを使用します。

コマンドレットで ? を入力すると、そのコマンドレットの構文、パラメータ、エイリアス、および説明が表示されます。

以下に、コマンドレットのヘルプを表示する例を示します。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Invoke–userAPISubmitServiceRequest –?

NAME
	   Invoke–userAPISubmitServiceRequest	

SYNTAX
	   Invoke–userAPISubmitServiceRequest [–catalogName] <string> [-vdcName] <string> [-durationHours] <int> [-beginTime] <long> [-
quantity] <int> [-comments] <string> [-server <string>] [-restkey <string>]

ALIASES
    None

REMARKS
    None

	
PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>

各コマンドレットには、必須パラメータとオプション パラメータがあります。たとえば、Invoke–userAPISubmitServiceRequest コマンドレットには、必須パラメータとして catalogName、オプション パラメータとして server および restKey があります。

get-Help コマンド、コマンドレット名、およびパラメータを使用すると、コマンドレットの個々のパラメータに関する詳しいヘルプを表示できます。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> get-Help Invoke–userAPISubmitServiceRequest –Parameter catalogName –catalogName <string>

  Required?                    true
  Position?                    0
  Accept pipeline input?       false
  Paramter set name            <All>
  Aliases                      None		
  Dynamic?                     None		


PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>
PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> get-Help Invoke–userAPISubmitServiceRequest –Parameter server

–server <string>

  Required?                    false
  Position?                    Named
  Accept pipeline input?       false
  Paramter set name            <All>
  Aliases                      None		
  Dynamic?                     false

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>

コマンドレットの入力定義

ワークフローを送信するコマンドレットは、名前と値のペアの配列をワークフロー入力として受け入れます。入力は、コロンで区切った名前と値のペアからなる配列として指定する必要があります。

Name1:value1, Name2:value2

たとえば、user-add-test という名前のワークフローを送信する場合、次のように入力を指定します。

Invoke-userAPISubmitWorkflowServiceRequest user-add-test -parameters user-type:Regular,group-id:1,login-name:cmdlettest1,password:test,confirm-password:test,email:user@mail.com

コマンドレットの出力タイプ

パイプ演算子（¦）で複数のコマンドを連結することで、コマンド出力に対して共通のオプションを実行できます。各コマンドの出力が、その次のコマンドの入力として使用されます。

次の表に、コマンドレットごとにパイプラインに書き込まれるオブジェクトのタイプを記載します。

コマンドレット	返されるオブジェクト タイプ
Invoke-userAPICancelServiceRequest	ブール値
Invoke-userAPIExecuteVMAction	文字列
Invoke-userAPIGetAllCatalogs	APITabularReport
Invoke-userAPIGetAllGroups	APITabularReport
Invoke-userAPIGetAllVDCs	APITabularReport
Invoke-userAPIGetAvailableReports	APIReportDefinition の配列
Invoke-userAPIGetHistoricalReport	HistoricalDataSeries の配列
Invoke-userAPIGetInstantDataReport	APISnapshotReport
Invoke-userAPIGetPage	VMDataViewPaginated
Invoke-userAPIGetServiceRequestDetails	APIServiceRequestDetails
Invoke-userAPIGetServiceRequests	APITabularReport
Invoke-userAPIGetServiceRequestWorkFlow	APIWorkflowStatus
Invoke-userAPIGetTabularReport	APITabularReport
Invoke-userAPIGetVMActionRequests	APITabularReport
Invoke-userAPIGetWorkflowInputs	APIWorkflowInputDetail の配列
Invoke-userAPIGetWorkflowInputValue	文字列
Invoke-userAPIGetWorkflowInputValues	WorkflowInputValue
Invoke-userAPIGetWorkflows	CustomActionDefinition の配列
Invoke-userAPIGetWorkflowStatus	整数（Integer）
Invoke-userAPIReconfigureVM	文字列
Invoke-userAPIRollbackWorkflow	SR ID
Invoke-userAPISubmitServiceRequest	SR ID
Invoke-userAPISubmitServiceRequestCustom	SR ID
Invoke-userAPISubmitWorkflowServiceRequest	SR ID
Invoke-userAPISubmitWorkflowServiceRequestWithGroup	SR ID
Invoke-userAPISubmitWorkflowServiceRequestWithStartTime AndDurationHours	SR ID
Invoke-userAPIValidateWorkFlow	APIWFValidationResult
Invoke-userAPIWorkflowInputDetails	APIWorkflowInputDetails

レポート表示のコマンドレット

レポートを表示するには、次のコマンドレットを使用できます。

• Invoke-UserAPIGetAllCatalogs

• Invoke-UserAPIGetAllGroups

• Invoke-UserAPIGetAvailableReports

• Invoke-UserAPIGetHistoricalReports

• Invoke-UserAPIGetInstantDataReport

• Invoke-UserAPIGetPage

• Invoke-UserAPIGetSeviceRequestDetails

• Invoke-UserAPIGetSeviceRequests

• Invoke-UserAPIGetSeviceRequestWorkflow

• Invoke-UserAPIGetTabularReport

• Invoke-UserAPIGetVMActionRequests

• Invoke-UserAPIGetWorkflowInputs

• Invoke-UserAPIGetWorkflowInputValue

• Invoke-UserAPIGetWorkflowInputValues

• Invoke-UserAPIGetWorkflows

• Invoke-UserAPIGetWorkflowStatus

• Invoke-UserAPIGetallVDCs

userAPIGetPage API はパラメータの 1 つとして、ページ番号付きレポートの名前を必要とします。

以下の表に、レポート名とそのコンテキスト値を示します。

レポート名（Report Name）	コンテキスト値
CHARGEBACK_DETAILS_SERVICES_GLOBAL_TABULAR	なし
PER_CLOUD_ARCHIVED_HYPERV_VM_LIST_REPORT	<cloudName>
vms.paginated.report	<cloudName>
PER_CLOUD_ARCHIVED_VM_LIST_REPORT	<cloudName>

たとえば、VMware アカウントのアカウント レポートのあるページを取得するには、次の入力を指定します。

Invoke-userAPIGetPage vms.paginated.report vmware-account 1 10

例：Help コマンドを使用したコマンドレットのパラメータの取得

コマンドレットは、他のすべての PowerShell コマンドと同じ方法で実行されます。パイプ演算子（¦）を使用することで、一般的な操作（検索やフィルタリングなど）をコマンドの出力に適用できます。

以下に示す例では、? コマンドを使用してコマンドレットのパラメータを取得する方法について示しています。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Invoke–userAPIGetWorkflowInputValues –?

NAME
	   Invoke–userAPIGetWorkflowInputValues	

SYNTAX
	   Invoke–userAPIGetWorkflowInputValues [–srId] <int> [-server <string>] [-restkey <string>] [<CommonParameters>]

ALIASES
    None

REMARKS
    None

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> 

例：コマンドレット出力のキャプチャとフィルタリング

コマンドレットの構文がわかっている場合は、次に示すようにコマンドレット出力をキャプチャできます。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Invoke–userAPIGetWorkflowInputValues 429

Input Set Id   Action Id    Field Id                       Field Value
------------   ---------    --------                       -----------
18             0            WF_EMPTY_INPUTS
18             156          input_0_user-type471           Regular
18             156          AddUser_231.OUTUT_USER_NAME    cmdlettest1
18             156          input_3_password453            test
18             156          input_4_confirm-password361    test
18             156          input_5_email1932              user@mail.com
18             156          input_1_group-id135            1
18             156          input_2_login-name867          cmdlettest1

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> 

さらに、次に示すように出力をフィルタリングできます。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Invoke–userAPIGetWorkflowInputValues 429 ¦ Select-Object 'Field Id', 'Field Value'

Field Id                                     Field Value
--------                                     -----------
WF_EMPTY_INPUTS
input_0_user-type471                         Regular
AddUser_231.OUTUT_USER_NAME                  cmdlettest1
input_3_password453                          test
input_4_confirm-password361                  test
input_5_email1932                            user@mail.com
input_1_group-id135                          1
input_2_login-name867                        cmdlettest1

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>

例：表形式レポートの表示

次の例は、Invoke-userAPIGetAllGroups API のオブジェクト値を示しています。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Invoke-userAPIGetAllGroups

com.cisco.cuic.api.client.APITabularReport@307e168

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>

「-verbose」を同じ構文に追加すると、表形式レポートの形式でグループのリストが表示されます。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Invoke-userAPIGetAllGroups -verbose

VERBOSE: Connected to the UCSD at 172.22.234.237, Getting the List of Groups...

VERBOSE: List of Groups returned by the UCSD.

GROUP_ID  GROUP_NAME  GROUP_CODE  GROUP_DESCRIPTION  SOURCE COST_CENTER  GROUP_CONTACT_NAME  GROUP_CONTACT_EMAIL_ADDRESS  BUDGET_REQUIRED  RESOURCE_LIMITS_SET
LDAP_ACCOUNT  HOST TAGS GROUP_SHARE_POLICY ALLOWS_RESOURCES_TO_USER TAG

1  Default Group  DEF  Default Group. All discovered VMs are placed in this group.  Local				System Administrator			No		No   No

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>

（注）	表形式レポートを返すすべての API では、表形式レポートを表示するには「-verbose」を構文に追加します。「-verbose」を追加しないと、オブジェクト タイプとそのアドレスのみが返されます。

例：サービス リクエストのキャンセル

ここでは、PowerShell コンソールからサービス要求をキャンセルする方法について説明します。

はじめる前に

Cisco UCS Director サーバに対してコマンドレットを実行する場合は、PowerShell コンソールで環境変数がすでに設定されていることを確認してください。詳細については、Cisco UCS Director PowerShell コンソールの設定を参照してください。

手順

---

ステップ 1	Get-Command を使用して、使用可能なコマンドレットのリストを表示します。サービス要求をキャンセルするためのコマンドレットは、Invoke–userAPICancelServiceRequest です。
ステップ 2	Invoke–userAPICancelServiceRequest コマンドレットのパラメータを取得するには、? コマンドを使用します。 PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Invoke–userAPICancelServiceRequest –? NAME Invoke–userAPICancelServiceRequest SYNTAX Invoke–userAPICancelServiceRequest [–requestId] <int> [-server <string>] [-restkey <string>] [<CommonParameters>] ALIASES None REMARKS None PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Invoke–userAPICancelServiceRequest コマンドレットを実行するために必要な入力は、以下のとおりです。 requestId：必須パラメータ server：オプション パラメータ restKey：オプション パラメータ （注）      コマンドレットの個々のパラメータについての詳細なヘルプを表示するには、get-Help コマンドを使用します。詳細については、コマンドレット向けヘルプを参照してください。
ステップ 3	以下のように、サービス要求 ID（この例では 79）を渡して、コマンドを実行します。 PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Invoke–userAPICancelServiceRequest 79 このコマンドは出力としてブール値を返します。サービス要求が正常にキャンセルされると、出力として True が返されます。 True PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>

---

トラブルシューティング

接続例外エラー

問題

接続例外エラーは、PowerShell API を呼び出したときに発生します。

説明

PowerShell API を呼び出したとき、次のエラー メッセージが表示されます。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> Invoke -userAPIGetAllCatalogs

INFO: I/O exception <java.net.ConnectException> caught when processing request:
Connection Refused: connect

INFO: Retrying Request

Invoke -userAPIGetAllCatalogs : Connection Refused: connect

+ Invoke -userAPIGetAllCatalogs
	+ CategoryInfo          : InvalidResult:	<Couldn't get the Catalogs:String> [Invoke -userAPIGetAllCatalogs], ConnectException
	+ FullyQualifiedErrorId : Couldn't get the Catalogs,CiscoUcsdPS.userAPIGetAllCatalogsCmdlet

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS>

ソリューション

PowerShell API を呼び出す前に、すべての Cisco UCS Director サービスがアップ状態で動作していることを確認します。サービスがダウンしている場合は、サービスを再起動して、PowerShell API を再度呼び出します。

実行中のスクリプトが無効

問題

PowerShell コンソールを起動できません。

説明

Cisco UCS Director PowerShell コンソールの起動時に、次のエラー メッセージが表示されます。

PS C:\Program Files (x86)\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS> C:\Windows\System32\windowspowershell\v1.0\powershell.exe -NoExit -File -\StartUcsdPS.ps1

Windows PowerShell
Copyright <c> 2013 Microsoft Corporation. All rights reserved.

File C:\Program Files <x86>\Cisco\Cisco UCS Director PowerShell Console\Modules\CiscoUcsdPS\StartUcsdPS.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Exeuction_Policies at http://go.microsoft.com/fwlink/?LinkID=135170.

	+ CategoryInfo          : SecurityError:	<:> [], ParentContainsErrorRecord Exception
	+ FullyQualifiedErrorId : UnauthorizedAccess	

ソリューション

実行ポリシーは、Cisco UCS Director PowerShell のセキュリティ戦略の一部です。これにより、（PowerShell プロファイルを含む）コンフィギュレーション ファイルをロードしてスクリプトを実行できるかどうかが決まります。また、どのスクリプトが実行前にデジタル署名の必要があるかも決まります。Set-ExecutionPolicy コマンドレットは、PowerShell 実行ポリシーのユーザ設定を変更します。

実行ポリシーを無制限に設定するには、Cisco UCS Director PowerShell コンソールを起動し、次のコマンドを使用します。

Set-ExecutionPolicy Unrestricted

コマンドレットの実行に失敗

問題

コマンドレットの実行中に、PowerShell コンソールが次のいずれかのエラーをスローします。

• Cisco UCS Director サーバに到達できませんでした。

• 操作のタイムアウト エラーが発生しました。

• IP/REST キーを空にすることはできません。

説明

環境変数 UCSD_RESTKEY および UCSD_SERVER を設定した後でも、コマンドレットの実行が失敗しました。

PS C:\UCSDPowerShellTest\Modules\CiscoUcsdPS> [Environment]::SetEnvironmentVariable("UCSD_SERVER","10.1.1.1","User")

PS C:\UCSDPowerShellTest\Modules\CiscoUcsdPS> [Environment]::SetEnvironmentVariable("UCSD_RESTKEY","5E8DA3924FDB4CC49213FCAAE2CBCEEB","User")

PS C:\UCSDPowerShellTest\Modules\CiscoUcsdPS> Invoke-userAPIGetAllGroups
Invoke-userAPIGetAllGroups : IP/REST Key can't be Empty
At line:1 char:1
+ Invoke-userAPIGetAllGroups
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~
   + CategoryInfo          : InvalidArgument: (server/restKey:String) [Invoke
   - userAPIGetAllGroups], ArgumentException

ソリューション

環境変数の変更は、PowerShell を閉じて再び開かないと有効になりません。環境変数を変更したときは、PowerShell コンソールを閉じて再度開いてください。

Copyright © 2016, Cisco Systems, Inc. All rights reserved.