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 [-ServiceDeployment] <ACServiceDeployment>
     [[-RunAsynchronously]] [<CommonParameters>]

■説明

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

■パラメーター

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

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

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

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

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

■入力

Microsoft.SystemCenter.CloudManager.PowerShell.ACServiceDeployment

■出力

System.Object

■エイリアス

なし

■メモ

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

■例

例1

$CloudSystem = Get-SCACCloudSystem -Name &quot;CloudSystem01.Contoso.com&quot;
$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 にストアされた最初のサービス デプロイをサスペンド状態とし、コマンドの実行が停止する前に、即座にコマンド シェルに制御を返すために、ジョブが非同期に実行します。

[参考]