Set-AzVMDiagnosticsExtension
在虛擬機上設定 Azure 診斷擴充功能。
語法
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 客體代理程式將擴充功能自動更新為較新的次要版本。
類型: | Boolean |
Position: | 10 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | IAzureContextContainer |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DiagnosticsConfigurationPath
指定組態檔的路徑。
類型: | String |
Position: | 2 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Location
指定虛擬機的位置。
類型: | String |
Position: | 7 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Name
指定延伸模組的名稱。
類型: | String |
別名: | ExtensionName |
Position: | 8 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-NoWait
啟動作業,並在作業完成之前立即傳回。 若要判斷作業是否已順利完成,請使用一些其他機制。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ResourceGroupName
指定虛擬機的資源群組名稱。
類型: | String |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-StorageAccountEndpoint
指定記憶體帳戶端點。
類型: | String |
Position: | 5 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-StorageAccountKey
指定記憶體帳戶金鑰。
類型: | String |
Position: | 4 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-StorageAccountName
指定記憶體帳戶名稱。
類型: | String |
Position: | 3 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-StorageContext
指定 Azure 記憶體內容。
類型: | IStorageContext |
Position: | 6 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-TypeHandlerVersion
指定要用於此虛擬機的擴充功能版本。 若要取得版本,請使用 PublisherName 參數的 Microsoft.Compute 值和 Type 參數的 VMAccessAgent 執行 Get-AzVMExtensionImage Cmdlet。
類型: | String |
別名: | HandlerVersion, Version |
Position: | 9 |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-VMName
指定此 Cmdlet 運作所在的虛擬機名稱。
類型: | String |
別名: | ResourceName |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |