Set-AzureVMChefExtension
Chef 拡張機能を仮想マシンに追加します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
構文
Set-AzureVMChefExtension
[-Version <String>]
-ValidationPem <String>
[-ClientRb <String>]
[-BootstrapOptions <String>]
[-RunList <String>]
[-JsonAttribute <String>]
[-ChefDaemonInterval <String>]
[-ChefServerUrl <String>]
[-ValidationClientName <String>]
[-OrganizationName <String>]
[-BootstrapVersion <String>]
[-Daemon <String>]
[-Secret <String>]
[-SecretFile <String>]
[-Windows]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Set-AzureVMChefExtension
[-Version <String>]
-ValidationPem <String>
[-ClientRb <String>]
[-BootstrapOptions <String>]
[-RunList <String>]
[-JsonAttribute <String>]
[-ChefDaemonInterval <String>]
[-ChefServerUrl <String>]
[-ValidationClientName <String>]
[-OrganizationName <String>]
[-BootstrapVersion <String>]
[-Daemon <String>]
[-Secret <String>]
[-SecretFile <String>]
[-Linux]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
説明
Set-AzureVMChefExtension コマンドレットは、Chef 拡張機能を仮想マシンに追加します。
例
例 1: Windows 仮想マシンに Chef 拡張機能を追加する
PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ClientRb "C:\\client.rb" -RunList "Apache" -Windows;
このコマンドは、Windows 仮想マシンに Chef 拡張機能を追加します。 仮想マシンが起動すると、Chef でブートストラップされ、その上で Apache が実行されます。
例 2: ブートストラップを使用して Windows 仮想マシンに Chef 拡張機能を追加する
PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -BootstrapOptions '{"chef_node_name":"your_node_name","chef_server_url":"https://api.opscode.com/organizations/some-org", "validation_client_name":"some-org-validator"}' -RunList "Apache" -Windows;
このコマンドは、Windows 仮想マシンに Chef 拡張機能を追加します。 仮想マシンが起動すると、Chef でブートストラップされ、その上で Apache が実行されます。 ブートストラップ後、仮想マシンは JSON 形式で指定された BootstrapOptions を参照します。
例 3: Windows 仮想マシンに Chef 拡張機能を追加し、Apache と GIT をインストールする
PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ChefServerUrl "http://ipaddress:port" -ValidationClientName "MyOrg-Validator" -RunList "apache, git" -Windows;
このコマンドは、Windows 仮想マシンに Chef 拡張機能を追加します。 仮想マシンが起動すると、Chef でブートストラップされ、Apache と GIT がインストールされます。 client.rb を指定しない場合は、Chef サーバーの URL と検証クライアント名を指定する必要があります。
例 4: Linux 仮想マシンに Chef 拡張機能を追加する
PS C:\> Set-AzureVMChefExtension -VM $VM -ValidationPem "C:\\myorg-validator.pem" -ChefServerUrl "http://ipaddress:port" -OrganizationName "MyOrg" -Linux;
このコマンドは、Linux 仮想マシンに Chef 拡張機能を追加します。 仮想マシンが起動すると、Chef でブートストラップされます。 client.rb を指定しない場合は、Chef サーバーの URL と組織を指定する必要があります。
パラメーター
-BootstrapOptions
JavaScript Object Notation (JSON) 形式のブートストラップ オプションを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-BootstrapVersion
拡張機能と共にインストールされる Chef クライアントのバージョンを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ChefDaemonInterval
chef-service を実行する頻度 (分単位) を指定します。 Chef サービスを Azure VM にインストールしたくない場合は、このフィールドに値 0 を設定します。
型: | String |
Aliases: | ChefServiceInterval |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ChefServerUrl
Chef サーバーの URL を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ClientRb
Chef client.rb の完全パスを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Daemon
chef-client サービスを自動実行用に構成します。 ノード プラットフォームは Windows である必要があります。 使用できるオプション: 'none'、'service'、'task'。 none - 現在、chef-client サービスがサービスとして構成されないようにします。 service - サービスとしてバックグラウンドで自動的に実行されるように chef-client を構成します。 task - バックグラウンドで自動的に実行されるように chef-client を設定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- 阻止
- [中断]
型: | ActionPreference |
Aliases: | infa |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InformationVariable
情報変数を指定します。
型: | String |
Aliases: | iv |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JsonAttribute
chef-client の最初の実行に追加される JSON 文字列。 例: -JsonAttribute '{"foo" : "bar"}'
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Linux
このコマンドレットによって Linux ベースの仮想マシンが作成されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-OrganizationName
Chef 拡張機能の組織名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunList
Chef ノードの実行リストを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Secret
データ バッグ項目の値の暗号化と暗号化解除に使用される暗号化キー。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-SecretFile
データ バッグ項目の値の暗号化と暗号化解除に使用される暗号化キーを含むファイルへのパス。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ValidationClientName
検証クライアントの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ValidationPem
Chef 検証コントロールの .pem ファイル パスを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Version
Chef 拡張機能のバージョン番号を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VM
永続的な仮想マシン オブジェクトを指定します。
型: | IPersistentVM |
Aliases: | InputObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Windows
このコマンドレットによって Windows 仮想マシンが作成されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |