Set-AzVMBginfoExtension

リファレンス

モジュール:: Az.Compute

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

構文

Set-AzVMBginfoExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-AzV MB (メガバイト)GInfoExtension コマンドレットは、BGInfo 拡張機能を仮想マシンに追加します。

例

例 1: 仮想マシンの BGInfo 拡張機能を追加する

Set-AzVMBgInfoExtension -ResourceGroupName "ContosoRG" -VMName "ContosoVM" -Name "ExtensionName" -TypeHandlerVersion "2.1" -Location "West Europe"

このコマンドは、ContosoVM という名前の仮想マシンに BGInfo 拡張機能を追加します。このコマンドは、仮想マシンのリソースグループと場所を指定します。このコマンドは、拡張機能の名前とバージョンを指定します。

パラメーター

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
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

-DisableAutoUpgradeMinorVersion

このコマンドレットにより、Azure ゲストエージェントが拡張機能を新しいマイナーバージョンに自動的に更新できないようにすることを示します。既定では、このコマンドレットを使用すると、ゲストエージェントは拡張機能を更新できます。

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

-ForceRerun

同じパブリック設定または保護された設定で拡張機能を再度実行することを指定します。値には、現在の値とは異なる任意の文字列を指定できます。 forceUpdateTag が変更されていない場合でも、ハンドラーによってパブリックまたは保護された設定の更新が適用されます。

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

-Location

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

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

-Name

このコマンドレットが仮想マシンに追加する BGInfo 拡張機能の名前を指定します。

Type:	String
Aliases:	ExtensionName
Position:	Named
Default value:	None
Required:	True
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

-ResourceGroupName

このコマンドレットが拡張機能を追加する仮想マシンのリソースグループの名前を指定します。

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

-TypeHandlerVersion

このコマンドレットが仮想マシンに追加する拡張機能のバージョンを指定します。

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

-VMName

このコマンドレットが BGInfo 拡張機能を追加する仮想マシンの名前を指定します。

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

入力

String

SwitchParameter

出力

PSAzureOperationResponse