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

■パラメーター

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

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

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

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

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

■入力

■出力

System.Object

■エイリアス

なし

■メモ

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

■例

例1

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

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

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

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

[参考]

• Add-SCACUserRoleScope – System Center 2012 – App Controller 2012 Service Pack1
  http://technet.microsoft.com/en-us/library/jj899771.aspx 
• Add-SCACUserRoleScope – System Center 2012 – App Controller 2012
  http://technet.microsoft.com/en-us/library/hh781172.aspx
• Cmdlets in System Center 2012 – App Controller
  http://technet.microsoft.com/en-us/library/gg696045.aspx