System Center 2012 – App Controller で使用できる PowerShell コマンドレット (Add-SCACUserRoleScope) について

スポンサーリンク

System Center 2012 – App Controller 2012 は、PowerShell を用いてプライベートおよびパブリック クラウドのサービス管理を行うことが可能です。

このヘルプ情報について、日本語として纏めてみました (内容については「Get-Help」コマンドレットの -Full オプションを用いて実行した結果を編集、意訳したものとなります)。

この記事では、「Add-SCACUserRoleScope」コマンドレットについて記載します (他のコマンドレットについては、「System Center 2012 – App Controller で使用できる PowerShell コマンドレットについて」を参照)。

■名前

Add-SCACUserRoleScope

■概要

ユーザー ロールが管理できるオブジェクトのスコープへ、Windows Azure サブスクリプションおよび Service Provider Foundation 接続クラウド オブジェクトに追加します。

■構文

Add-SCACUserRoleScope [-UserRole] <ACUserRole>
     [-AzureSubscriptionScope] <ACAzureSubscriptionCloud> [<CommonParameters>]

Add-SCACUserRoleScope [-UserRole] <ACUserRole>
     [-ServiceProviderConnectionScope] <ACCloudSystem> [-VmmUserRoleName] <string>
     [<CommonParameters>]

■説明

Add-SCACUserRoleScope ファンクションは、ユーザー ロールが管理できるオブジェクトのスコープへ、Windows Azure サブスクリプションおよび Service Provider Foundation 接続クラウド オブジェクトに追加します。このコマンドレットは、Virtual Machine Manager (VMM) クラウドでのみ動作します。

■パラメーター

-AzureSubscriptionScope <ACAzureSubscriptionCloud>
Windows Azure サブスクリプション クラウド オブジェクトを指定します。クラウド オブジェクトを取得するために、Get-SCACCloud コマンドレットを使用してください。

必須true
位置1
パイプライン入力を許可するfalse
パラメーター セット名AzureScope
エイリアスなし
動的false

-ServiceProviderConnectionScope <ACCloudSystem>
Service Provider Foundation クラウド システム オブジェクトを指定します。クラウド システム オブジェクトを取得するために Get-SCACCloudSystem コマンドレットを使用してください。

必須true
位置1
パイプライン入力を許可するfalse
パラメーター セット名SPFScope
エイリアスなし
動的false

-UserRole <ACUserRole>
ユーザー ロール オブジェクトを指定します。ユーザー ロールを取得するために、Get-SCACUserRole コマンドレットを使用してください。

必須true
位置0
パイプライン入力を許可するfalse
パラメーター セット名(すべて)
エイリアスなし
動的false

-VmmUserRoleName <string>
Virtual Machine Manager (VMM) ユーザー ロール名を指定します。

必須true
位置2
パイプライン入力を許可するfalse
パラメーター セット名SPFScope
エイリアスなし
動的false

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: VerboseDebugErrorActionErrorVariableWarningActionWarningVariableOutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。

■入力

■出力

System.Object

■エイリアス

なし

■メモ

このコマンドレットを含むモジュールのヘルプ ファイルをダウンロードしてインストールするには、Update-Help 使用してください。

■例

例1

$UserRole = Get-SCACUserRole -Managed | where {$_.Name -eq &quot;UserRole01&quot;}
$CloudSystem = Get-SCACCloudSystem -Name &quot;SvcProvider01.Contoso.com&quot;
Add-SCACUserRoleScope -UserRole $UserRole -ServiceProviderConnectionScope $CloudSystem -VMMUserRoleName &quot;TenantSSUserRole01&quot;

最初のコマンドは、ユーザー ロール「UserRole1」を取得し、$UserRole 変数にオブジェクトをストアします。

2 番目のコマンドは、クラウド システム オブジェクト「SvcProvider01.Contoso.com」を取得し、$CloudSystem 変数にオブジェクトをストアします。

最後のコマンドは、UserRole01 のスコープへ $CouldSystem にストアされたクラウド システムを追加します。

[参考]