Register-SCVMHost

VMware ESX ホストを仮想マシン ホストとして VMM に関連付け、ホストを管理するための資格情報を指定します。

構文

Register-SCVMHost
        [-VMHost] <Host>
        [-Credential <VMMCredential>]
        [-TCPPort <UInt32>]
        [-Certificate <ClientCertificate>]
        [-SshTcpPort <UInt32>]
        [-SshPublicKey <ClientSshPublicKey>]
        [-SshPublicKeyFile <String>]
        [-RunAsynchronously]
        [-PROTipID <Guid>]
        [-JobVariable <String>]
        [<CommonParameters>]

説明

Register-SCVMHost コマンドレットは、VMware ESX ホストと仮想マシン マネージャー (VMM) を仮想マシン ホストとして関連付け、この ESX ホストで使用する資格情報を指定します。

例 1: 特定の VMware ESX ホストの資格情報を設定する

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "ESX Host Computer Acct"
PS C:\> $ESXHost = Get-SCVMHost -ComputerName "ESXHost02.Contoso.com"
PS C:\> Register-SCVMHost -VMHost $ESXHost -Credential $RunAsAccount

最初のコマンドは、ESX Host Computer Acct という名前の実行アカウント オブジェクトを取得し、$RunAsAccount変数にオブジェクトを格納します。

2 番目のコマンドは、ESXHost02 という名前の ESX ホスト オブジェクトを取得し、$ESXHost変数にオブジェクトを格納します。

最後のコマンドは、VMware ESX ホストをマネージド ホストとして VMM に関連付け、$Credentialに格納されている実行アカウントを使用して ESXHost02 にアクセスするように指定します。

例 2: 特定の VMware ESX ホストの資格情報と証明書を設定する

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "ESX Host Computer Acct"
PS C:\> $ESXHost = Get-SCVMHost -ComputerName "ESXHost03.contoso.com"
PS C:\> $Cert = Get-SCCertificate -ComputerName "ESXHost03.contoso.com"
PS C:\> Register-SCVMHost -VMHost $ESXHost -Credential $RunAsAccount -Certificate $Cert

最初のコマンドは、ESX Host Computer Acct という名前の実行アカウント オブジェクトを取得し、$RunAsAccount変数にオブジェクトを格納します。 この操作に必要な資格情報は、ルート アカウント (ルート/<パスワード>) か、この ESX ホストの VirtualCenter Server で前に定義した VMware 委任管理者のアカウントです。

2 番目のコマンドは、ESXHost03 という名前の VMware ESX ホスト オブジェクトを取得し、$ESXHost変数にオブジェクトを格納します。

3 番目のコマンドでは 、Get-SCCertificate コマンドレットを使用して ESXHost02 から証明書オブジェクトを取得し、そのオブジェクトを $Cert 変数に格納します。

最後のコマンドは、この VMware ESX Server をマネージド ホストとして VMM に関連付け、ESXHost02 にアクセスするために使用される資格情報が$RunAsAccountに格納されているものであることを指定します。

パラメーター

-Certificate

セキュリティ証明書オブジェクトを指定します。

Type:ClientCertificate
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:VMMCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

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

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

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

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

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

-SshPublicKey

Secure Shell (SSH) プロトコルで使用する公開キーを指定します。

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

-SshPublicKeyFile

ターゲット ホストとの間でセキュリティで保護された SSH チャネルを確立するための公開キー ファイルへのパスを指定します。

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

-SshTcpPort

SSH プロトコルで使用される TCP ポート番号を指定します。

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

-TCPPort

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

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

-VMHost

仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされます。

各種類のホストの詳細については、 Add-SCVMHost コマンドレットを参照してください。

Type:Host
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

出力

Host

このコマンドレットは 、Host オブジェクトを返します。