Get-SCVMMServer

  • リファレンス
モジュール:
VirtualMachineManager

接続がまだ存在しない場合は VMM 管理サーバーに接続するか、別の VMM 管理サーバーに接続します。

構文

Get-SCVMMServer
   [-ComputerName] <String>
   [-TCPPort <Int32>]
   [-ConnectAs <Profile>]
   [-UserRoleName <String>]
   [-Credential <PSCredential>]
   [-RetainObjectCache]
   [-RetainDeletedObjects]
   [-AllowJobGC]
   [-SetAsDefault]
   [-ForOnBehalfOf]
   [<CommonParameters>]

説明

接続がまだ存在しない場合、 Get-SCVMMServer コマンドレットは仮想マシン マネージャー (VMM) 管理サーバーに接続し、VMM データベースからサーバー オブジェクトを取得します。 VMM サーバーへの接続に使用される既定のポートは TCP ポート 8100 です。

ユーザー インターフェイス (UI) を使用して VMM 管理サーバーへの接続を作成した場合、VMM コマンド シェルを開くと、そのコマンド シェルは自動的に同じ VMM 管理サーバーに接続します。 UI を使用して VMM 管理サーバーに接続していない場合は、 Get-SCVMMServer を使用して接続を確立する必要があります。 VMM コマンド シェルのみを使用して VMM 管理サーバーに接続する場合は、 SetAsDefault パラメーターを使用してセッション間の接続を保持するか、新しい VMM コマンド シェル セッションを開くたびに VMM サーバーに再接続する必要があることに注意してください。

Get-VMMServer を使用して、別の VMM 管理サーバーに接続することもできます。

VMM 管理サーバーへの接続が確立されると、VMM コマンド シェル コマンド ラインで実行されるすべてのコマンドが、VMM コマンド シェル ウィンドウを閉じるまで、VMM サーバー オブジェクトが必要な既存の接続を自動的に使用します。

VMM 管理サーバーで実行されている VMM サービスは、VMM データベースをサポートします。 このデータベースは、VMM 管理サーバー自体またはSQL Serverを実行している別のサーバー上の Microsoft SQL Serverに格納されます。

VMM サービスを使用すると、ホスト サーバー (仮想マシンをホストするサーバー)、ライブラリ サーバー (VMM ライブラリ リソースを格納するサーバー)、ホストまたはライブラリに格納されている仮想マシンなど、仮想環境を管理できます。

VMM 管理サーバーへの接続の詳細については、「 Get-Help about_VMM_2016_Connecting_to_the_VMM_Server.

例

例 1: VMM サーバーに接続する

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"

このコマンドは、Contoso ドメインにある VMMServer01 という VMM サーバーに接続し、VMM データベースからサーバー オブジェクトを取得します。

例 2: 特定のポートを使用して VMM サーバーに接続する

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com" -TCPPort 8100

このコマンドは、CONTOSO ドメインにある VMMServer01 という VMM サーバーに TCP ポート 8100 経由で接続します。

例 3: VMM サーバーに接続し、その .NET オブジェクトの種類、メソッド、プロパティを取得する

PS C:\> $VMMServer = Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VMMServer | Get-Member
PS C:\> $VMMServer | Get-Member | Format-List

最初のコマンドは、VMMServer01 という名前の VMM サーバー オブジェクトを取得し、そのオブジェクトを $VMMServer 変数に格納します。

2 番目のコマンドは、$VMMServerに格納されている VMM サーバー オブジェクトを Get-Member コマンドレットに渡します。このコマンドレットは、次の値を取得して表示します。

  • TypeName: VMM サーバー オブジェクトの .NET 型名: Microsoft.SystemCenter.VirtualMachineManager.Remoting.ServerConnection

  • MemberType: このオブジェクト型に関連付けられている各イベント、メソッド、およびプロパティの名前と定義を含むリスト。

3 番目のコマンドは、2 番目のコマンドと同じ情報を取得して表示します。ただし、出力を Format-List コマンドレットにパイプ処理して、各メソッドと VMM サーバー オブジェクトの各プロパティの完全な定義を表示します。

例 4: 別のユーザー ロールを持つ別の VMM サーバーに接続する

PS C:\> Get-SCVMMServer -ComputerName "VMMServer02.Contoso.com" -ConnectAs "DelegatedAdmin"

このコマンドは、DelegatedAdmin ユーザー ロールを使用して、Contoso ドメインにある VMMServer02 という VMM サーバーに接続します。

パラメーター

-AllowJobGC

ジョブに対してガベージ コレクションが許可されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

ネットワーク内で Virtual Machine Manager が一意に識別できるコンピュータの名前を指定します。 このパラメーターの有効値は、次のとおりです。

  • FQDN
  • IPv4 または IPv6 アドレス
  • NetBIOS 名
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ConnectAs

VMM コマンド シェルから VMM 管理サーバーに接続するときに、ユーザーが複数のロールのメンバーである場合に使用する VMM ユーザー ロールを指定します。 このパラメーターの有効値は、次のとおりです。

  • 管理者
  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser

VMM 管理者は、すべての VMM オブジェクトを管理できます。 委任された管理者とセルフサービス ユーザーは、ユーザー ロールのスコープ内にあるオブジェクトにのみアクセスおよび変更できます。 Read-Only管理者は、既存のオブジェクトのプロパティのみを表示できます。新しいオブジェクトを作成したり、既存のオブジェクトのプロパティを変更したりすることはできません。

Type:Profile
Accepted values:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

資格情報オブジェクトを指定するか、一部のコマンドレットに対して、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。 または、 Restart-SCJob の場合は、再起動されたタスクを完了するためのアクセス許可を持ちます。

PSCredential オブジェクトの詳細については、「Get-Help Get-Credential.

実行アカウントの詳細については、「.」と入力します Get-Help New-SCRunAsAccount。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForOnBehalfOf

管理者が VMM コマンドレットで OnBehalfOf パラメーター (使用可能な場合) を使用できることを示します。 このパラメーターは、主に VMM への Service Provider Foundation 接続に使用されます。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RetainDeletedObjects

削除のマークが付けられたキャッシュ内のオブジェクトを保持することを指定します。 このパラメーターは、VMM コマンド シェルの上にユーザー インターフェイスを作成する場合にのみ必要になることがあります。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RetainObjectCache

キャッシュ内のオブジェクトがメモリ内に残り、ガベージ コレクションによって回収されないことを示します。 VMM コマンド シェルの上にユーザー インターフェイスを作成する場合は、このパラメーターが必要になる場合があります。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SetAsDefault

$Trueに設定すると、VMM コマンド シェルがこのセッションの指定した VMM 管理サーバーに接続し、その接続を今後のセッションに保持することを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TCPPort

TCP ポートを表す数値を指定します。

Type:Int32
Aliases:Port
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRoleName

ユーザー ロールの名前を指定します。 名前付きのユーザー ロールの種類は次のとおりです。

  • 代理管理者
  • 読み取り専用の管理者
  • セルフサービス ユーザー
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False