Set-AzureRMVMDiagnosticsExtension
在虛擬機上設定 Azure 診斷擴充功能。
警告
自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。
雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。
語法
Set-AzureRMVMDiagnosticsExtension
[-ResourceGroupName] <String>
[-VMName] <String>
[-DiagnosticsConfigurationPath] <String>
[[-StorageAccountName] <String>]
[[-StorageAccountKey] <String>]
[[-StorageAccountEndpoint] <String>]
[[-StorageContext] <IStorageContext>]
[[-Location] <String>]
[[-Name] <String>]
[[-TypeHandlerVersion] <String>]
[[-AutoUpgradeMinorVersion] <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Set-AzureRmVMDiagnosticsExtension Cmdlet 會在虛擬機上設定 Azure 診斷擴充功能。
範例
範例 1：使用診斷組態檔中指定的記憶體帳戶啟用診斷
PS C:\> Set-AzureRmVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml"此命令會使用診斷組態檔來啟用診斷。 檔案diagnostics_publicconfig.xml包含診斷延伸模組的公用 XML 組態，包括將傳送診斷數據的記憶體帳戶名稱。 診斷記憶體帳戶必須與虛擬機位於相同的訂用帳戶中。
範例 2：使用記憶體帳戶名稱啟用診斷
PS C:\> Set-AzureRmVMDiagnosticsExtension -ResourceGroupName "ResourceGroup1" -VMName "VirtualMachine2" -DiagnosticsConfigurationPath diagnostics_publicconfig.xml -StorageAccountName "MyStorageAccount"此命令會使用記憶體帳戶名稱來啟用診斷。 如果診斷組態未指定記憶體帳戶名稱，或您想要覆寫組態檔中指定的診斷記憶體帳戶名稱，請使用 StorageAccountName 參數。 診斷記憶體帳戶必須與虛擬機位於相同的訂用帳戶中。
範例 3：使用記憶體帳戶名稱和金鑰啟用診斷
PS C:\> Set-AzureRmVMDiagnosticsExtension -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 |
| 別名: | 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 |
-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
指定要用於此虛擬機的擴充功能版本。 若要取得版本，請執行 Get-AzureRmVMExtensionImage Cmdlet，其值為 Microsoft.Compute for the PublisherName 參數，以及 Type 參數的 VMAccessAgent。
| 類型: | String |
| 別名: | HandlerVersion, Version |
| Position: | 9 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-VMName
指定此 Cmdlet 運作所在的虛擬機名稱。
| 類型: | String |
| 別名: | ResourceName |
| Position: | 1 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |