Set-AzVMDiagnosticsExtension

參考

模組:: Az.Compute

在虛擬機上設定 Azure 診斷擴充功能。

Syntax

Set-AzVMDiagnosticsExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-DiagnosticsConfigurationPath] <String>
   [[-StorageAccountName] <String>]
   [[-StorageAccountKey] <String>]
   [[-StorageAccountEndpoint] <String>]
   [[-StorageContext] <IStorageContext>]
   [[-Location] <String>]
   [[-Name] <String>]
   [[-TypeHandlerVersion] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzVMDiagnosticsExtension Cmdlet 會在虛擬機上設定 Azure 診斷擴充功能。

範例

範例 1：使用診斷組態檔中指定的記憶體帳戶啟用診斷

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml"

此命令會使用診斷組態檔來啟用診斷。檔案diagnostics_publicconfig.xml包含診斷延伸模組的公用 XML 組態，包括將傳送診斷數據的記憶體帳戶名稱。診斷記憶體帳戶必須與虛擬機位於相同的訂用帳戶中。

範例 2：使用記憶體帳戶名稱啟用診斷

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup1" -VMName "VirtualMachine2" -DiagnosticsConfigurationPath diagnostics_publicconfig.xml -StorageAccountName "MyStorageAccount"

此命令會使用記憶體帳戶名稱來啟用診斷。如果診斷組態未指定記憶體帳戶名稱，或您想要覆寫組態檔中指定的診斷記憶體帳戶名稱，請使用 儲存體 AccountName 參數。診斷記憶體帳戶必須與虛擬機位於相同的訂用帳戶中。

範例 3：使用記憶體帳戶名稱和金鑰啟用診斷

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml" -StorageAccountName "MyStorageAccount" -StorageAccountKey $storage_key

此命令會使用記憶體帳戶名稱和金鑰來啟用診斷。如果診斷記憶體帳戶位於與虛擬機不同的訂用帳戶中，請藉由明確指定其名稱和密鑰，將診斷數據傳送至該儲存體帳戶。

參數

-AutoUpgradeMinorVersion

指出此 Cmdlet 是否允許 Azure 客體代理程式將擴充功能自動更新為較新的次要版本。

Type:	Boolean
Position:	10
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

-DiagnosticsConfigurationPath

指定組態檔的路徑。

Type:	String
Position:	2
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

指定延伸模組的名稱。

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

-ResourceGroupName

指定虛擬機的資源群組名稱。

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

-StorageAccountEndpoint

指定記憶體帳戶端點。

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

-StorageAccountKey

指定記憶體帳戶金鑰。

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

-StorageAccountName

指定記憶體帳戶名稱。

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

-StorageContext

指定 Azure 記憶體內容。

Type:	IStorageContext
Position:	6
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TypeHandlerVersion

指定要用於此虛擬機的擴充功能版本。若要取得版本，請使用 PublisherName 參數的 Microsoft.Compute 值和 Type 參數的 VMAccessAgent 執行 Get-AzVMExtensionImage Cmdlet。

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

-VMName

指定此 Cmdlet 運作所在的虛擬機名稱。

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

輸入

String

IStorageContext

Boolean

輸出

PSAzureOperationResponse