Set-AzVMProxyAgentSetting
PSVirtualMachine オブジェクトのプロキシ エージェント設定プロパティを設定します。
構文
Default (既定)
Set-AzVMProxyAgentSetting
-VM <PSVirtualMachine>
[-EnableProxyAgent <Boolean>]
[-WireServerMode <String>]
[-WireServerProfile <String>]
[-ImdsMode <String>]
[-ImdsProfile <String>]
[-KeyIncarnationId <Int32>]
[-AddProxyAgentExtension <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
PSVirtualMachine オブジェクトのプロキシ エージェント設定プロパティを設定します。
例
例 1
$vmconfig = New-AzVMConfig -VMName $vmName -VMSize "Standard_D2s_v3"
Set-AzVMProxyAgentSetting -VM $vmconfig -EnableProxyAgent $true -AddProxyAgentExtension false -WireServerMode "Enforce" -ImdsProfile "/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}"
このコマンドは、仮想マシン構成オブジェクト $vmconfigのプロキシ エージェント設定を設定します。
プロキシ エージェントを有効にし、ワイヤ サーバー モードを "強制" に設定し、IMDS プロファイルを指定します。
パラメーター
-AddProxyAgentExtension
ProxyAgent 拡張機能を暗黙的にインストールするかどうかを指定します。 現在、このオプションは Linux OS にのみ適用されます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
パラメーターのプロパティ
型: IAzureContextContainer
規定値: None ワイルドカードのサポート: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: False 残りの引数からの値: False
-EnableProxyAgent
メタデータ セキュリティ プロトコル (ProxyAgent) 機能を有効にするかどうかを指定します。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-ImdsMode
IMDS エンドポイント実行モードを指定します。
監査モードでは、システムは、ログにアクセス拒否エントリを出力するなど、アクセス制御ポリシーを適用しているかのように機能しますが、実際にはホスト エンドポイントへの要求を拒否しません。
強制モードでは、システムはアクセス制御を強制し、推奨される操作モードです。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-ImdsProfile
IMDS エンポイントの InVMAccessControlProfileVersion リソース ID を指定します。
/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleryName}/inVMAccessControlProfiles/{profile}/versions/{version} の形式
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-KeyIncarnationId
このパラメーターの値を大きくすると、ユーザーはゲストとホスト間の通信チャネルをセキュリティで保護するために使用されるキーをリセットできます。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-VM
New-AzVMConfig から作成された PSVirtualMachine オブジェクト。
パラメーターのプロパティ
パラメーター セット
(All)
配置: Named 必須: True パイプラインからの値: True プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-WireServerMode
仮想マシンまたは仮想マシン スケール セットの作成時に Wire Server エンドポイント実行モードを指定します。
監査モードでは、システムは、ログにアクセス拒否エントリを出力するなど、アクセス制御ポリシーを適用しているかのように機能しますが、実際にはホスト エンドポイントへの要求を拒否しません。
強制モードでは、システムはアクセス制御を強制し、推奨される操作モードです。
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
-WireServerProfile
Wire Server エンドポイントの InVMAccessControlProfileVersion リソース ID を指定します。
/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleryName}/inVMAccessControlProfiles/{profile}/versions/{version} の形式
パラメーターのプロパティ
型: String
規定値: None ワイルドカードのサポート: False DontShow: False
パラメーター セット
(All)
配置: Named 必須: False パイプラインからの値: False プロパティ名別のパイプラインからの値: True 残りの引数からの値: False
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParameters を参照してください。
出力