Set-AzVMChefExtension

Chef 拡張機能を仮想マシンに追加します。

構文

Set-AzVMChefExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [[-TypeHandlerVersion] <String>]
   -ValidationPem <String>
   [-ClientRb <String>]
   [-BootstrapOptions <String>]
   [-JsonAttribute <String>]
   [-ChefDaemonInterval <String>]
   [-Daemon <String>]
   [-Secret <String>]
   [-SecretFile <String>]
   [-RunList <String>]
   [-ChefServerUrl <String>]
   [-ValidationClientName <String>]
   [-OrganizationName <String>]
   [-BootstrapVersion <String>]
   [-Linux]
   [[-Location] <String>]
   [[-Name] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzVMChefExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [[-TypeHandlerVersion] <String>]
   -ValidationPem <String>
   [-ClientRb <String>]
   [-BootstrapOptions <String>]
   [-JsonAttribute <String>]
   [-ChefDaemonInterval <String>]
   [-Daemon <String>]
   [-Secret <String>]
   [-SecretFile <String>]
   [-RunList <String>]
   [-ChefServerUrl <String>]
   [-ValidationClientName <String>]
   [-OrganizationName <String>]
   [-BootstrapVersion <String>]
   [-Windows]
   [[-Location] <String>]
   [[-Name] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzVMChefExtension コマンドレットは、Chef 拡張機能を仮想マシンに追加します。

例 1: Windows 仮想マシンに Chef 拡張機能を追加する

Set-AzVMChefExtension -ResourceGroupName "ResourceGroup001" -VMName "WindowsVM001" -ValidationPem "C:\my-org-validator.pem" -ClientRb "C:\client.rb" -RunList "Apache" -Daemon "service" -SecretFile "C:\my_encrypted_data_bag_secret" -Windows

このコマンドは、WindowsVM001 という名前の Windows 仮想マシンに Chef 拡張機能を追加します。 仮想マシンが起動すると、Chef によって仮想マシンがブートストラップされ、Apache が実行されます。

例 2: Linux 仮想マシンに Chef 拡張機能を追加する

Set-AzVMChefExtension -ResourceGroupName "ResourceGroup002" -VMName "LinuxVM001" -ValidationPem "C:\my-org-validator.pem" -ClientRb "C:\client.rb" -RunList "Apache" -Secret "my_secret" -Linux

このコマンドは、LinuxVM001 という名前の Linux 仮想マシンに Chef 拡張機能を追加します。 仮想マシンが起動すると、Chef によって仮想マシンがブートストラップされ、Apache が実行されます。

例 3: ブートストラップ オプションを使用して Windows 仮想マシンに Chef 拡張機能を追加する

Set-AzVMChefExtension -ResourceGroupName "ResourceGroup003" -VMName "WindowsVM002" -ValidationPem C:\my-org-validator.pem -ClientRb C:\client.rb -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

このコマンドは、WindowsVM002 という名前の Windows 仮想マシンに Chef 拡張機能を追加します。 仮想マシンが起動すると、Chef によって仮想マシンがブートストラップされ、Apache が実行されます。 ブートストラップ後、仮想マシンは JSON 形式で指定された BootstrapOptions を参照します。

パラメーター

-AutoUpgradeMinorVersion

Type:Boolean
Position:10
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-BootstrapOptions

client_rb オプションの構成設定を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-BootstrapVersion

ブートストラップ構成のバージョンを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ChefDaemonInterval

chef-service を実行する頻度 (分単位) を指定します。 Chef サービスを Azure VM にインストールしたくない場合は、このフィールドに値 0 を設定します。

Type:String
Aliases:ChefServiceInterval
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ChefServerUrl

Chef サーバー リンクを URL として指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ClientRb

Chef client.rb の完全パスを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Daemon

chef-client サービスを自動実行用に構成します。 ノード プラットフォームは Windows である必要があります。 使用できるオプション: 'none'、'service'、'task'。 none - 現在、chef-client サービスがサービスとして構成されないようにします。 service - サービスとしてバックグラウンドで自動的に実行されるように chef-client を構成します。 task - スケジュールされたタスクとしてバックグラウンドで自動的に実行されるように chef-client を構成します。

Type:String
Accepted values:none, service, task
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JsonAttribute

chef-client の最初の実行に追加される JSON 文字列。 例: -JsonAttribute '{"foo" : "bar"}'

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Linux

このコマンドレットによって Windows 仮想マシンが作成されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Location

仮想マシンの場所を指定します。

Type:String
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Chef 拡張機能の名前を指定します。

Type:String
Aliases:ExtensionName
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NoWait

操作を開始し、操作が完了する直前に戻ります。 操作が正常に完了したかどうかを判断するには、他のメカニズムを使用します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OrganizationName

Chef 拡張機能の組織名を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

仮想マシンを含むリソース グループの名前を指定します。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RunList

Chef ノードの実行リストを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Secret

データ バッグ項目の値の暗号化と暗号化解除に使用される暗号化キー。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SecretFile

データ バッグ項目の値の暗号化と暗号化解除に使用される暗号化キーを含むファイルへのパス。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TypeHandlerVersion

この仮想マシンに使用する拡張機能のバージョンを指定します。

Type:String
Aliases:HandlerVersion, Version
Position:9
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ValidationClientName

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ValidationPem

Chef 検証コントロールの .pem ファイル パスを指定します

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMName

仮想マシンの名前を指定します。 このコマンドレットは、このパラメーターが指定する仮想マシンの Chef 拡張機能を追加します。

Type:String
Aliases:ResourceName
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Windows

このコマンドレットによって Windows 仮想マシンが作成されることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

入力

String

Boolean

出力

PSAzureOperationResponse