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