Set-AzureVMChefExtension

  • リファレンス
モジュール:
Azure

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
  • Stop
  • [中断]
型: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