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"此命令會使用記憶體帳戶名稱來啟用診斷。 如果診斷組態未指定記憶體帳戶名稱，或您想要覆寫組態檔中指定的診斷記憶體帳戶名稱，請使用 StorageAccountName 參數。 診斷記憶體帳戶必須與虛擬機位於相同的訂用帳戶中。
範例 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 |
