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 オブジェクトを返します。