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

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

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

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

■名前

Suspend-SCACServiceDeployment

■概要

指定したサービス デプロイをサスペンド状態にします。

■構文

■説明

Suspend-SCACServiceDeployment コマンドレットは、指定したサービス デプロイをサスペンド状態にします。

■パラメーター

-RunAsynchronously
即座にコマンド シェルに制御を返すために、ジョブが非同期に実行するように指定します。

-ServiceDeployment <ACServiceDeployment>
サービス デプロイ オブジェクトを指定します。サービス デプロイ オブジェクトを取得するために、Get-SCACServiceDeployment コマンドレットを使用します。

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

■入力

Microsoft.SystemCenter.CloudManager.PowerShell.ACServiceDeployment

■出力

System.Object

■エイリアス

なし

■メモ

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

■例

例1

$CloudSystem = Get-SCACCloudSystem -Name "CloudSystem01.Contoso.com"
$Cloud = Get-SCACCloud -CloudSystem $CloudSystem
$SvcDeployment = @(Get-SCACServiceDeployment -Cloud $Cloud)
Suspend-SCACServiceDeployment -ServiceDeployment $SvcDeployment[0] -RunAsynchronously

最初のコマンドは、クラウド システム オブジェクト名「CloudSystem01」を取得し、$CloudSystem 変数にオブジェクトをストアします。

2 番目のコマンドは、$CloudSyste にストアされたクラウド システムに対するクラウド オブジェクトを取得し。$Cloud 変数にクラウド オブジェクトにストアします。

3 番目のコマンドは、$Cloud にストアされたクラウドに対するすべてのサービス デプロイ オブジェクトを取得し、$SvcDeployment 配列にオブジェクトをストアします。

最後のコマンドは、$SvcDeployment にストアされた最初のサービス デプロイをサスペンド状態とし、コマンドの実行が停止する前に、即座にコマンド シェルに制御を返すために、ジョブが非同期に実行します。

[参考]

• Suspend-SCACServiceDeployment– System Center 2012 – App Controller 2012 Service Pack1
  http://technet.microsoft.com/en-us/library/jj899774.aspx
• Suspend-SCACServiceDeployment – System Center 2012 – App Controller 2012
  http://technet.microsoft.com/en-us/library/hh781159.aspx
• Cmdlets in System Center 2012 – App Controller
  http://technet.microsoft.com/en-us/library/gg696045.aspx