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

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

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

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

■名前

Get-SCACServer

■概要

App Controller サーバーの接続情報および接続を確立します。

■構文

■説明

Get-SCACServer コマンドレットは、指定した App Controller サーバーの接続情報、および接続を確立します。他のどの App Controller コマンドレットを実行する前に、このコマンドを実行する必要があります。

■パラメーター

-Credential <pscredential>
このオプションを実行するためのユーザー アカウント権限を指定します。 PSCredential オブジェクトを生成するために、Get-Credential コマンドレットを使用します。

-ServerName <string>
App Controller サーバー名を指定します。

-UserRole <string>
ユーザーロール名を指定します。

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

■入力

System.Management.Automation.PSCredential

■出力

System.Object

■エイリアス

なし

■メモ

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

■例

例1

$Credentials = Get-Credential
Get-SCACServer -ServerName "https://AppControllerSvr01.Contoso.com" -Credential $Credentials

最初のコマンドは、App Controller サーバーへの接続権限を持つ証明書を適用するために促し、$Credentials パラメーターに証明書をストアします。

2 番目のコマンドは、$Credentials にストアされた証明書を用いて、App Controller サーバー名「AppControllerSvr01」への接続を確立します。

例2

$Credentials = Get-Credential
$ACServer = Get-SCACServer -ServerName "https://AppControllerSvr01.Contoso.com" -Credential $Credentials
$ACServer

最初のコマンドは、App Controller サーバーへの接続権限を持つ証明書を適用するために促し、$Credentials パラメーターに証明書をストアします。

2 番目のコマンドは、$Credentials にストアされた証明書を用いて、App Controller サーバー名「AppControllerSvr01」への接続を確立し、$ACServer 変数に接続をストアします。他のコマンドレットへサーバー情報を提供するために、$ACServer を使用することができます。

最後のコマンドは、ユーザーへ $ACServer へストアされた App Controller サーバーに関する情報を表示します。

[参考]

• Get-SCACServer – System Center 2012 – App Controller 2012 Service Pack1
  http://technet.microsoft.com/en-us/library/jj899757.aspx
• Get-SCACServer – System Center 2012 – App Controller 2012
  http://technet.microsoft.com/en-us/library/hh781163.aspx
• Cmdlets in System Center 2012 – App Controller
  http://technet.microsoft.com/en-us/library/gg696045.aspx