PowerCLI での vSphere Auto Deploy の仕組み

PowerCLI コマンドレットを使用した vSphere Auto Deploy の管理

PowerCLI コマンドレットを使用して、ホストをイメージプロファイル、ホストプロファイル、カスタムスクリプト、および vCenter Server ターゲット上の場所に関連付けるルールを作成して、vSphere Auto Deploy を管理できます。また、ルールのコンプライアンスをテストし、コンプライアンスの問題を修復して、ホストのアップデートを実行できます。

PowerCLIを使用した vSphere Auto Deploy プロセスの概要

vSphere Auto Deploy の使用を開始するには、vSphere Auto Deploy のしくみについて学ぶこと、vSphere Auto Deploy サーバをインストールすること、PowerCLIをインストールすること、ホストをプロビジョニングするPowerCLI ルールを記述すること、ユーザーが指定するイメージプロファイルで起動されるホストをパワーオンすることが必要です。イメージプロファイル、ホストプロファイル、および vCenter Serverの場所をカスタマイズできます。

初めて vSphere Auto Deploy 環境を設定する際に役立つ順を追った説明については、vSphere Auto Deploy の vSphere PowerCLI シナリオを参照してください。

vSphere Auto Deploy を使用して環境内にホストを正しくプロビジョニングするには、次の手順に従います。

vCenter Serverをデプロイします。
vSphere Auto Deploy サーバが含まれています。
vSphere Auto Deploy サービスの起動タイプを構成します。
vSphere Auto Deploy 用にシステムを準備を参照してください。
vSphere Auto Deploy と vSphere ESXi Image Builder コマンドレットを含む PowerCLIをインストールします。
vSphere ESXi Image Builderの構成、vSphere Auto Deploy コマンドレットの使用、およびVMware.Image Builder コマンドレットの使用を参照してください。
ホストにデプロイする VIB を含むイメージプロファイルを探します。
- 多くの場合、必要なソフトウェアを含むデポを PowerCLIセッションに追加してから、それらのデポのいずれかからイメージプロファイルを選択します。
- カスタムのイメージプロファイルを作成する場合は、vSphere ESXi Image Builder コマンドレットを使用して既存のイメージプロファイルのクローンを作成し、そのクローンにカスタム VIB を追加します。カスタムのイメージプロファイルを PowerCLIセッションに追加します。
vSphere ESXi Image Builder をカスタマイズ用に使用する必要があるのは、VIB の追加または削除が必要な場合のみです。ほとんどの場合は、VMware がイメージプロファイルをホストするデポを PowerCLIセッションに URL として追加できます。
PowerCLIセッションを開始し、vSphere Auto Deploy が登録される vCenter Server システムに接続します。
New-DeployRulePowerCLI コマンドレットを使用して、1 つのホスト、パターンによって指定される複数のホスト、またはすべてのホストにイメージプロファイルを割り当てるルールを記述します。
```
New-DeployRule -Name "testrule" -Item image-profile -AllHosts
```
イメージプロファイルのホストへの割り当てを参照してください。

注： vSphere Auto Deploy は、MAC アドレスと IP アドレスのマッピングが DHCP に固定されている（DHCP 予約とも呼ばれる）ホストのプロビジョニング用に最適化されています。固定 IP アドレスを使用する場合は、ホストプロファイルを設定して、ホストをカスタマイズするためのプロンプトを表示する必要があります。詳細については、『 vSphere のホストプロファイル』ドキュメントを参照してください。
プロビジョニングするホストをパワーオンします。
プロビジョニングしたホストを、ホストプロファイルのリファレンスホストとして設定します。
リファレンスホストの Syslog 設定、ファイアウォール設定、ストレージ、ネットワークなどを指定できます。
プロビジョニングしたホストを、ホストプロファイルのリファレンスホストとして設定します。
リファレンスホストの Syslog 設定、ファイアウォール設定、ストレージ、ネットワークなどを指定できます。vSphere Auto Deploy のリファレンスホストの設定を参照してください。
リファレンスホストのホストプロファイルを作成してエクスポートします。
ホストプロファイルドキュメントを参照してください。
ホストプロファイルを使用して複数のホストをプロビジョニングするには、Copy-DeployRuleコマンドレットを使用して、以前に作成されたルールを編集します。
イメージプロファイルだけでなく、ホストプロファイル、vCenter Serverの場所、カスタムスクリプトバンドルも割り当てるようにルールを変更します。
```
Copy-DeployRule -DeployRule "testrule" -ReplaceItem my_host_profile_from_reference_host,my_target_cluster
               -ReplacePattern  "ipv4=192.XXX.1.10-192.XXX.1.20"
```
ここで my_host_profile_from_reference_host はリファレンスホストのプロファイルの名前、my_target_cluster はターゲットクラスタの名前です。
テストと修復のコンプライアンス処理を実行し、ホストを修正します。
ルールのコンプライアンスのテストおよび修復を参照してください。
プロビジョニングしたホストが、次の要件を満たしていることを確認します。
- 各ホストが vCenter Server システムに接続されている。
- ホストがメンテナンスモードではない。
- ホストにコンプライアンスのエラーがない。
- ユーザー入力が必要なホストプロファイルを持つ各ホストに、最新のカスタマイズ情報が提供されている
すべてのホストが要件を満たすまで、ホストの関連付けとコンプライアンスの問題を修正して、ホストを再起動します。

起動プロセスの概要、最初の起動と 2 回目以降の起動の違い、およびホストのカスタマイズを使用した場合の概要については、を参照してください。

vSphere Auto Deploy コマンドレットの使用

vSphere Auto Deploy コマンドレットは、Microsoft PowerShell コマンドレットとして実装され、PowerCLI に含まれます。vSphere Auto Deploy コマンドレットのユーザーは、すべての PowerCLI 機能を利用できます。

PowerShell に精通しているユーザーは、ほかの PowerShell コマンドレットと同じように vSphere Auto Deploy コマンドレットを使用することができます。PowerShell および PowerCLI に慣れていない場合は、次のヒントが役立つ場合があります。

コマンドレット、パラメータ、およびパラメータの値は、PowerCLI のシェルに入力できます。

Get-Help cmdlet_name を実行すると、任意のコマンドレットのヘルプを表示することができます。
PowerShell は大文字と小文字を区別しないことに注意してください。
コマンドレット名やパラメータ名には、タブ補完を使用します。
Format-List または Format-Table （短縮形式は fl または ft）を使用して、任意の変数およびコマンドレットの出力の形式を整えることができます。詳細を確認する場合は、Get-Help Format-List コマンドレットを実行してください。

名前によるパラメータの指定

パラメータは多くの場合名前で渡すことができ、スペースや特殊文字を含むパラメータの値は二重引用符で囲むことができます。

 Copy-DeployRule -DeployRule testrule -ReplaceItem MyNewProfile

vCenter Server のインストールとセットアップドキュメントのほとんどの例では、パラメータは名前で渡されます。

オブジェクトによるパラメータの指定

スクリプト処理や自動化を実施する場合は、パラメータをオブジェクトとして渡すことができます。パラメータをオブジェクトとして渡すことは、複数のオブジェクトを返す cmdlet や、単一のオブジェクトを返すコマンドレットで便利です。次の例を想定します。

ホストのルールセットのコンプライアンス情報をカプセル化するオブジェクトを、変数にバインドします。
```
$tr = Test-DeployRuleSetCompliance MyEsxi42
```
オブジェクトの itemlist プロパティを表示して、ルールセットの内容と現在ホストが使用している内容の違いを確認します。
```
$tr.itemlist
```
Repair-DeployRuleSetCompliance コマンドレットを変数とともに使用して、変更されたルールセットを使用するようにホストを修正します。
```
Repair-DeployRuleSetCompliance $tr
```

この例では、次にホストを起動するときにホストが修復されます。

vSphere Auto Deploy PowerCLI コマンドレットの概要

PowerCLI に含まれる一連の PowerCLI コマンドレットを使用して、イメージプロファイルおよびホストプロファイルをホストに割り当てるルールを指定します。

PowerCLI に慣れていない場合は、PowerCLI のマニュアルを読み、vSphere Auto Deploy コマンドレットの使用を参照してください。PowerShell プロンプトで任意のコマンドのヘルプを表示できます。

基本的なヘルプ: Get-Help cmdlet_name
詳細なヘルプ：Get-Help cmdlet_name -Detailed

注： vSphere Auto Deploy コマンドレットを実行する場合は、コマンドラインですべてのパラメータを指定して実行します。対話モードでのパラメータの提供は推奨されません。

表 1. ルールエンジンの PowerCLI コマンドレット
コマンド	説明
Get-DeployCommand	vSphere Auto Deploy コマンドレットのリストを返します。
New-DeployRule	指定された項目およびパターンで新しいルールを作成します。
Set-DeployRule	指定された項目およびパターンで既存のルールを更新します。ルールセットに含まれるルールは更新できません。
Get-DeployRule	指定された名前のルールを取得します。
Copy-DeployRule	既存のルールのクローンを作成して更新します。
Add-DeployRule	作業ルールセットに 1 つ以上のルールを追加し、デフォルトで、アクティブなルールセットにも追加します。作業ルールセットにのみルールを追加するには、NoActivate パラメータを使用します。
Remove-DeployRule	作業ルールセットおよびアクティブなルールセットから、1 つ以上のルールを除外します。ルールを完全に削除するには、-Delete パラメータとともにこのコマンドを実行します。
Set-DeployRuleset	作業ルールセット内のルールのリストを明示的に設定します。
Get-DeployRuleset	現在の作業ルールセットまたは現在アクティブなルールセットを取得します。
Switch-ActiveDeployRuleset	すべての新しい要求がこのルールセットで評価されるようにするために、ルールセットをアクティブ化します。
Get-VMHostMatchingRules	パターンに一致するルールを取得します。たとえば、1 つまたは複数のホストに適用されるすべてのルールを取得できます。デバッグの前に、このコマンドレットを使用します。
Test-DeployRulesetCompliance	指定されたホストに関連付けられた項目が、アクティブなルールセットに準拠しているかどうかを確認します。
Repair-DeployRulesetCompliance	この cmdlet は、Test-DeployRulesetCompliance の出力に基づいて、イメージプロファイル、ホストプロファイル、および vCenter Server インベントリ内の各ホストの場所を更新します。この cmdlet は、イメージプロファイルの適用、ホストプロファイルの適用、または、vCenter Server システム上の事前に指定されたフォルダまたはクラスタへのホストの移動を行う場合があります。
Apply-EsxImageProfile	指定されたイメージプロファイルを指定されたホストに関連付けます。
Get-VMHostImageProfile	指定されたホストによって使用されているイメージプロファイルを取得します。このコマンドレットは、vSphere ESXi Image Builder の Get-EsxImageProfile コマンドレットとは異なります。
Repair-DeployImageCache	このコマンドレットは、vSphere Auto Deploy のイメージキャッシュが誤って削除された場合にのみ使用します。
Get-VMHostAttributes	vSphere Auto Deploy サーバがルールを評価する際に使用されたホストの属性を取得します。
Get-DeployMachineIdentity	vCenter Server 内の ESXi ホストを物理マシンに論理的にリンクするときに vSphere Auto Deploy が使用する文字列の値を返します。
Set-DeployMachineIdentity	vCenter Server データベース内のホストオブジェクトを、物理マシンに論理的にリンクします。この cmdlet は、ルールを指定せずにホストを追加する場合に使用します。
Get-DeployOption	vSphere Auto Deploy のグローバル構成オプションを取得します。このコマンドレットは現在、vlan-id オプションをサポートしており、vSphere Auto Deploy でプロビジョニングされたホストの ESXi 管理ネットワークでデフォルトの VLAN ID を指定します。vSphere Auto Deploy は、ホストプロファイルなしでホストが起動した場合のみ、この値を使用します。
Set-DeployOption	グローバル構成オプションの値を設定します。ESXi 管理ネットワークのデフォルトの VLAN ID の設定では、vlan-id オプションは現在サポートされています。
Add-ProxyServer	プロキシサーバを vSphere Auto Deploy データベースに追加します。IPv4 アドレスまたは IPv6 アドレスを指定するための -Address パラメータを使用して、コマンドを実行します。アドレスにはポート番号を含めることができます。
List-ProxyServer	現在 vSphere Auto Deploy に登録されているプロキシサーバを一覧表示します。
Delete-ProxyServer	vSphere Auto Deploy に登録されているプロキシサーバのリストから 1 台以上のプロキシサーバを削除します。プロキシサーバのリストから -id パラメータを使用してコマンドを実行したり、-Address パラメータを使用して、削除するプロキシサーバの IPv4 アドレスまたは IPv6 アドレスを指定することによってコマンドを実行できます。
Add-ScriptBundle	1 つ以上のスクリプトバンドルを vSphere Auto Deploy サーバに追加します。
Get-ScriptBundle	vSphere Auto Deploy サーバで使用可能なスクリプトバンドルおよびそれらに含まれるスクリプトのリストを取得します。
Remove-ScriptBundle	vSphere Auto Deploy からスクリプトバンドルを削除します。vSphere バージョン 6.7 以降で使用できます。
Get-CustomCertificate	AutoDeploy にアップロードされたカスタムホスト証明書を取得します。-HostId [MAC_Address \| BIOS_UUID] パラメータを指定してコマンドを実行する必要があります。カスタム証明書を初めて追加するとき、このコマンドレットによって返されて表示される証明書はありません。
List-CustomCertificates	Auto Deploy によって使用されるすべてのカスタムホスト証明書に関する情報を取得します。リストには、証明書の名前、Host ID、Associated Host Name の詳細が表示されます。これには、Auto Deploy サーバの vCenter Server の名前が反映されています。
Add-CustomCertificate	カスタム証明書を VMware Endpoint Certificate Store に追加し、ESXi ホストに関連付けます。ホストが再起動すると証明書が有効になります。Get-CustomCertificate コマンドレットを使用して、カスタムホスト証明書キーを取得できます。-HostId [MAC_Address \| BIOS_UUID] パラメータを指定してコマンドを実行することにより、-Key [file:///path/to/key.key] と -Cert [file:///path/to/cert.crt] を指定して証明書をホストに関連付けることができます。このコマンドレットを使用するには、vCenter Server のルートフォルダに対する AutoDeploy.Rule.Create 権限が必要です。
Remove-CustomCertificate	一連のカスタムホスト証明書を Auto Deploy から削除します。証明書エントリがデータベースから削除され、証明書ファイルがファイルストアから削除されます。すでにカスタム証明書を使用して起動しているホストは、新しい証明書を受け取るために再起動する必要があります。-Cert パラメータまたは -HostId パラメータの少なくとも 1 つを指定する必要があります。このコマンドレットを使用するには、vCenter Server のルートフォルダに対する AutoDeploy.Rule.Create 権限が必要です。

イメージプロファイルのホストへの割り当て

ホストをプロビジョニングする前に、vSphere Auto Deploy を使用してプロビジョニングする各ホストにイメージプロファイルを割り当てるルールを作成する必要があります。

vSphere Auto Deploy の拡張ルールは、ESXCLI プラグインパス、jumpstart プラグインパスなど、事前定義された特定の場所のファイルのみを CommunitySupported レベルの VIB に含めることを強制します。別の場所にある VIB をイメージプロファイルに追加すると、警告が表示されます。force オプションを使用して警告をオーバーライドできます。

ルールに違反する CommunitySupported レベルの VIB を含むイメージプロファイルで New-DeployRule コマンドレットを呼び出す場合は、イメージプロファイルを追加する前に $DeployNoSignatureCheck = $true を設定します。これを設定すると、システムは署名の検証を無視し、拡張ルールのチェックを実行しません。

注： CommunitySupported レベルの VIB を含むイメージプロファイルは、本番システムではサポートされません。

手順

PowerCLI セッションで Connect-VIServer コマンドレットを実行し、vSphere Auto Deploy が登録される vCenter Server システムに接続します。
```
Connect-VIServer ipv4_or_ipv6_address
```
このコマンドレットはサーバ証明書の警告を返す場合があります。本番環境では、サーバ証明書の警告が表示されないことを確認します。開発環境では、この警告は無視できます。
パブリックなソフトウェアデポの場所を特定するか、vSphere ESXi Image Builder を使用してカスタムのイメージプロファイルを定義します。

Add-EsxSoftwareDepot を実行して、イメージプロファイルが含まれるソフトウェアデポを PowerCLI セッションに追加します。

デポのタイプ	コマンドレット
リモートデポ	`Add-EsxSoftwareDepot depot_url` を実行します。
ZIP ファイル	ZIP ファイルをローカルファイルパスにダウンロードします。 `Add-EsxSoftwareDepot C:\file_path\my_offline_depot.zip` を実行します。

Get-EsxImageProfile cmdlet を実行して、デポ内の使用するイメージプロファイルを探します。
デフォルトでは、 ESXi デポには、VMware Tools を含んだ 1 つの基本イメージプロファイル（名前に文字列 standard を含む）と、VMware Tools を含まない 1 つの基本イメージプロファイルが格納されています。
IP アドレスの範囲などの特定の属性を持つホストに、イメージプロファイルを割り当てるためのルールを定義します。
```
New-DeployRule -Name "testrule" -Item "My Profile25" -Pattern "vendor=Acme,Zven", "ipv4=192.XXX.1.10-192.XXX.1.20"
```
名前にスペースが含まれる場合は二重引用符の使用が必須ですが、それ以外の場合は任意です。項目をすべてのホストに適用するには、パターンの代わりに -AllHosts を指定します。
コマンドレットは testrule という名前のルールを作成します。このルールは、My Profile25 という名前のイメージプロファイルを、Acme または Zven というベンダーの、指定された範囲内の IP アドレスを持つすべてのホストに割り当てます。
ルールセットにルールを追加します。
```
Add-DeployRule testrule
```
デフォルトでは、ルールは作業ルールセットとアクティブなルールセットの両方に追加されます。 NoActivate パラメータを使用すると、作業ルールセットはアクティブなルールセットになりません。

結果

ホストが iPXE から起動する場合、ホストはマシンの属性をコンソールにレポートします。デプロイのルールを記述する際には、同じ形式の属性を使用します。

******************************************************************
* Booting through VMware AutoDeploy...
*
* Machine attributes:
* . asset=No Asset Tag
* . domain=vmware.com
* . hostname=myhost.mycompany.com
* . ipv4=XX.XX.XXX.XXX
* . mac=XX:Xa:Xb:Xc:Xx:XX
* . model=MyVendorModel
* . oemstring=Product ID: XXXXXX-XXX
* . serial=XX XX XX XX XX XX...
* . uuid=XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX
* . vendor=MyVendor
******************************************************************

次のタスク

vSphere Auto Deploy ですでにプロビジョニングされたホストについては、コンプライアンステストおよび修復を実施して、新しいイメージプロファイルでそれらのホストがプロビジョニングされるようにします。ルールのコンプライアンスのテストおよび修復を参照してください。
プロビジョニングされていないホストを起動し、新しいイメージプロファイルを使用してそれらのホストがプロビジョニングされるようにします。

ルールの記述とホストへのホストプロファイルの割り当て

vSphere Auto Deploy は、1 台以上の ESXi ホストにホストプロファイルを割り当てることができます。

多くの場合、ホストプロファイルを明示的に指定する代わりに、ホストをクラスタに割り当てます。ホストは、割り当てられたクラスタのホストプロファイルを使用します。

前提条件

ホストプロファイルには、ストレージ構成、ネットワーク構成、またはホストのその他の特性に関する情報が含まれる場合があります。クラスタにホストを追加する場合は、そのクラスタのホストプロファイルが使用されます。

PowerCLI および前提となるすべてのソフトウェアをインストールします。詳細については、vCenter Server Installation and Setupを参照してください。
使用するホストプロファイルをエクスポートします。

手順

PowerCLI セッションで Connect-VIServer コマンドレットを実行し、vSphere Auto Deploy が登録される vCenter Server システムに接続します。
```
Connect-VIServer ipv4_or_ipv6_address
```
このコマンドレットはサーバ証明書の警告を返す場合があります。本番環境では、サーバ証明書の警告が表示されないことを確認します。開発環境では、この警告は無視できます。
vSphere Client を使用して、使用する設定内容をホストに設定し、そのホストでホストプロファイルを作成します。
Get-VMhostProfile PowerCLI コマンドレットを実行して、ホストプロファイルの作成元となる ESXi ホストを渡すことで、ホストプロファイルの名前を探します。
PowerCLI プロンプトで、特定の属性（IP アドレスの範囲など）を備えたホストをホストプロファイルに割り当てるルールを定義します。
```
New-DeployRule -Name "testrule2" -Item my_host_profile -Pattern "vendor=Acme,Zven", "ipv4=192.XXX.1.10-192.XXX.1.20"
```
指定された属性を持つすべてのホストに、指定された項目が割り当てられます。この例は、testrule2 という名前のルールを指定します。このルールは、指定された範囲内の IP アドレスを持ち、メーカーが Acme または Zven のすべてのホストに、指定されたホストプロファイル my_host_profile を割り当てます。
ルールセットにルールを追加します。
```
Add-DeployRule testrule2
```
デフォルトでは、作業ルールセットがアクティブなルールセットになります。また、ルールセットへのすべての変更は、ルールを追加した時にアクティブになります。 NoActivate パラメータを使用すると、作業ルールセットはアクティブなルールセットになりません。

次のタスク

vSphere Auto Deploy によってプロビジョニング済みのホストを新しいホストプロファイルに割り当てるには、それらのホスト上でコンプライアンステストおよび修復処理を実行します。詳細については、ルールのコンプライアンスのテストおよび修復を参照してください。
プロビジョニングされていないホストをパワーオンし、ホストプロファイルを使用してそれらのホストをプロビジョニングします。

ルールの記述とフォルダまたはクラスタへのホストの割り当て

vSphere Auto Deploy は、ホストをフォルダまたはクラスタに割り当てることができます。vSphere Auto Deploy は、ホストの起動時にそのホストをvCenter Server上の指定された場所に追加します。クラスタに割り当てられたホストは、クラスタのホストプロファイルを継承します。

前提条件

システムの準備および Auto Deploy サーバのインストール詳細については、vSphere Auto Deploy 用にシステムを準備を参照してください。
選択したフォルダがデータセンター内またはクラスタ内に存在することを確認します。ホストはスタンドアロンの最上位のフォルダに割り当てることはできません。

手順

PowerCLI セッションで Connect-VIServer コマンドレットを実行し、vSphere Auto Deploy が登録される vCenter Server システムに接続します。
```
Connect-VIServer ipv4_or_ipv6_address
```
このコマンドレットはサーバ証明書の警告を返す場合があります。本番環境では、サーバ証明書の警告が表示されないことを確認します。開発環境では、この警告は無視できます。
IP アドレスの範囲などの特定の属性を持つホストを、フォルダまたはクラスタに割り当てるルールを定義します。
```
New-DeployRule -Name testrule3 -Item "my folder"	-Pattern "vendor=Acme,Zven", "ipv4=192.XXX.1.10-192.XXX.1.20"
```
この例では、フォルダを名前で渡します。これ以外に、 Get-Folder、 Get-Cluster、または Get-Datacenter コマンドレットで取得するフォルダ、クラスタ、またはデータセンターオブジェクトを渡すこともできます。
ルールセットにルールを追加します。
```
Add-DeployRule testrule3
```
デフォルトでは、作業ルールセットがアクティブなルールセットになります。また、ルールセットへのすべての変更は、ルールを追加した時にアクティブになります。 NoActivateパラメータを使用すると、作業ルールセットはアクティブなルールセットになりません。

次のタスク

vSphere Auto Deploy によってすでにプロビジョニングされているホストを新しいフォルダまたはクラスタの場所に割り当てるには、コンプライアンスのテストと修復を実行します。ルールのコンプライアンスのテストおよび修復を参照してください。
プロビジョニングされていないホストを起動し、指定された vCenter Serverの場所にそれらのホストを追加します。

カスタムスクリプトの実行によるステートレスシステムの構成

vSphere Auto Deploy を使用して、カスタムスクリプトを vSphere Auto Deploy ルールに関連付けることで、1 台以上のホストを構成できます。

スクリプトは、ホストの最初の ESXi の起動ワークフロー後に、アルファベット順に実行されます。

前提条件

vSphere Auto Deploy ルールに関連付けるスクリプトバンドルの形式が .tgz で、最大サイズが 10 MB、Python または BusyBox ash スクリプト言語で記述されていることを確認します。

手順

PowerCLI セッションで Connect-VIServer コマンドレットを実行し、vSphere Auto Deploy が登録される vCenter Server システムに接続します。
```
Connect-VIServer ipv4_or_ipv6_address
```
このコマンドレットはサーバ証明書の警告を返す場合があります。本番環境では、サーバ証明書の警告が表示されないことを確認します。開発環境では、この警告は無視できます。
Add-ScriptBundle コマンドレットを実行して、必要なスクリプトを含むスクリプトバンドルを vSphere Auto Deploy インベントリに追加します。
```
Add-ScriptBundle c:/temp/MyScriptBundle.tgz
```
.tgz 拡張子を持たないスクリプトバンドルの名前は、スクリプトバンドル項目の名前識別子またはオブジェクトです。 Add-ScriptBundle コマンドレットと -Update パラメータを使用して、既存のスクリプトバンドルを更新できます。
（オプション） Get-ScriptBundle コマンドレットを実行して、スクリプトバンドルが vSphere Auto Deploy インベントリに追加されていることを確認します。
IP アドレスの範囲などの特定の属性持つホストを、スクリプトバンドルに割り当てるためのルールを定義します。
```
New-DeployRule -Name "testrule4" -Item "MyScriptBundle" -Pattern "vendor=Acme,Zven", "ipv4=192.XXX.1.10-192.XXX.1.20"
```
名前にスペースが含まれる場合は二重引用符の使用が必須ですが、それ以外の場合は任意です。項目をすべてのホストに適用するには、パターンの代わりに -AllHosts を指定します。
testrule4 という名前のルールを作成します。このルールは、My Script Bundle という名前のスクリプトバンドルを、Acme または Zven というベンダーの、指定された範囲内の IP アドレスを持つすべてのホストに割り当てます。スクリプトバンドルの名前識別子、または Get-ScriptBundle コマンドレットによって返されたオブジェクトを使用して、ルールに関連付けるスクリプトバンドルを識別できます。
ルールセットにルールを追加します。
```
Add-DeployRule testrule4
```
デフォルトでは、ルールは作業ルールセットとアクティブなルールセットの両方に追加されます。 NoActivate パラメータを使用すると、作業ルールセットはアクティブなルールセットになりません。

次のタスク

vSphere Auto Deploy ですでにプロビジョニングされたホストについては、コンプライアンステストおよび修復を実施して、新しいスクリプトでそれらのホストがプロビジョニングされるようにします。ルールのコンプライアンスのテストおよび修復を参照してください。
プロビジョニングされていないホストを起動し、新しいスクリプトを使用してそれらのホストがプロビジョニングされるようにします。

ルールのコンプライアンスのテストおよび修復

vSphere Auto Deploy ルールセットの変更は自動的に更新されないため、新しいルールまたは変更されたルールのコンプライアンスと修復を適宜テストします。

前提条件

vSphere Auto Deploy のルールセットにルールを追加したり、1 つ以上のルールを変更したりする場合、ホストは自動的にアップデートされません。ユーザーがルールのコンプライアンスのテストと修復を行った場合にのみ、vSphere Auto Deploy は新しいルールを適用します。

システムの準備および Auto Deploy サーバのインストール詳細については、vSphere Auto Deploy 用にシステムを準備を参照してください。
インフラストラクチャに vSphere Auto Deploy を使用してプロビジョニングされた ESXi ホストが 1 つ以上含まれており、PowerCLI をインストールしたホストがそれらの ESXi ホストにアクセスできることを確認します。

手順

PowerCLI セッションで Connect-VIServer コマンドレットを実行し、vSphere Auto Deploy が登録される vCenter Server システムに接続します。
```
Connect-VIServer ipv4_or_ipv6_address
```
このコマンドレットはサーバ証明書の警告を返す場合があります。本番環境では、サーバ証明書の警告が表示されないことを確認します。開発環境では、この警告は無視できます。
PowerCLI を使用して、現在使用可能な vSphere Auto Deploy ルールを確認します。
```
Get-DeployRule
```
システムは、該当するルールと、それに関連する項目およびパターンを返します。
使用可能なルールの 1 つを変更します。
たとえば、イメージプロファイルおよびルールの名前を変更することができます。
```
Copy-DeployRule -DeployRule testrule -ReplaceItem MyNewProfile 
			 
```
すでにアクティブなルールセットに追加されているルールは編集できません。代わりに、ルールをコピーして、変更する項目またはパターンを置き換えることはできます。
ルールセットのコンプライアンスをテストするホストにアクセスできることを確認します。
```
Get-VMHost -Name MyEsxi42
```
そのホストのルールセットのコンプライアンスをテストし、後で使用するために、戻り値を変数にバインドするコマンドレットを実行します。
```
$tr = Test-DeployRuleSetCompliance MyEsxi42
```
ルールセットの内容と、ホストの構成の間の差異を確認します。
```
$tr.itemlist
```
新しいルールセットのコンプライアンスをテストするホストが、アクティブなルールセットに準拠している場合は、現在のアイテムと予測されるアイテムの表が返されます。
```
CurrentItem                             ExpectedItem
-----------                             ------------   
My Profile 25                           MyNewProfile
```
ホストの次の起動時に、変更されたルールセットを使用するように、ホストを修復します。
```
Repair-DeployRuleSetCompliance $tr
```

次のタスク

変更したルールでインベントリの場所が指定されている場合、コンプライアンスの修復時に変更内容が即座に反映されます。それ以外のすべての変更内容は、ホストを再起動することで、vSphere Auto Deploy によって新しいルールが適用され、ルールセットとホスト間のコンプライアンスが達成されます。

vSphere Auto Deploy へのキャッシングプロキシサーバのアドレスの登録

多数のステートレスホストを同時に起動すると、vSphere Auto Deploy サーバに大きな負荷がかかります。vSphere Auto Deploy サーバと、vSphere Auto Deploy に登録する 1 つ以上のプロキシサーバ間で要求のロードバランシングを行うことができます。

前提条件

手順

PowerCLI セッションで Connect-VIServer コマンドレットを実行し、vSphere Auto Deploy が登録される vCenter Server システムに接続します。
```
Connect-VIServer ipv4_or_ipv6_address
```
このコマンドレットはサーバ証明書の警告を返す場合があります。本番環境では、サーバ証明書の警告が表示されないことを確認します。開発環境では、この警告は無視できます。
Add-ProxyServer コマンドレットを実行して、vSphere Auto Deploy にキャッシングプロキシサーバのアドレスを登録します。
```
Add-ProxyServer -Address 'https://proxy_server_ip_address:port_number'
```
複数のプロキシサーバを登録する場合は、コマンドレットを複数回実行します。アドレスにはポート番号を含めることができます。
（オプション） List-ProxyServer コマンドレットを実行して、vSphere Auto Deploy にキャッシングプロキシサーバが登録されていることを確認します。

PowerCLI コマンドレットを使用した vSphere Auto Deploy の管理

PowerCLIを使用した vSphere Auto Deploy プロセスの概要

vSphere Auto Deploy コマンドレットの使用

名前によるパラメータの指定

オブジェクトによるパラメータの指定

vSphere Auto Deploy PowerCLI コマンドレットの概要

イメージ プロファイルのホストへの割り当て

手順

結果

次のタスク

ルールの記述とホストへのホスト プロファイルの割り当て

前提条件

手順

次のタスク

ルールの記述とフォルダまたはクラスタへのホストの割り当て

前提条件

手順

次のタスク

カスタム スクリプトの実行によるステートレス システムの構成

前提条件

手順

次のタスク

ルールのコンプライアンスのテストおよび修復

前提条件

手順

次のタスク

vSphere Auto Deploy へのキャッシング プロキシ サーバ のアドレスの登録

前提条件

手順

イメージプロファイルのホストへの割り当て

ルールの記述とホストへのホストプロファイルの割り当て

カスタムスクリプトの実行によるステートレスシステムの構成

vSphere Auto Deploy へのキャッシングプロキシサーバのアドレスの登録