Set-AzureServiceDiagnosticsExtension
啟用指定角色或已部署服務或部署中所有角色的 Azure 診斷 擴充功能。
注意
本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。
Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。
重要
針對新客戶目前已取代 Azure 雲端服務 (傳統)，而針對所有客戶，該服務將從 2024 年 8 月 31 日起完全淘汰。 新部署應該使用 Azure Resource Manager 型的新部署模型 Azure 雲端服務 (延伸支援)。
語法
Set-AzureServiceDiagnosticsExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[[-X509Certificate] <X509Certificate2>]
[[-ThumbprintAlgorithm] <String>]
[[-StorageAccountName] <String>]
[[-StorageAccountKey] <String>]
[[-StorageAccountEndpoint] <String>]
[[-StorageContext] <AzureStorageContext>]
[-DiagnosticsConfigurationPath] <String>
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureServiceDiagnosticsExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[[-Role] <String[]>]
[[-CertificateThumbprint] <String>]
[[-ThumbprintAlgorithm] <String>]
[[-StorageAccountName] <String>]
[[-StorageAccountKey] <String>]
[[-StorageAccountEndpoint] <String>]
[[-StorageContext] <AzureStorageContext>]
[-DiagnosticsConfigurationPath] <String>
[[-Version] <String>]
[[-ExtensionId] <String>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Set-AzureServiceDiagnosticsExtension
[[-ServiceName] <String>]
[[-Slot] <String>]
[-DiagnosticsConfiguration] <ExtensionConfigurationInput[]>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>] Description
Set-AzureServiceDiagnosticsExtension Cmdlet 可在指定的角色或已部署服務或部署的所有角色上啟用 Azure 診斷 擴充功能。
範例
範例 1：啟用 Azure 診斷 擴充功能
PS C:\> Set-AzureServiceDiagnosticsExtension -ServiceName $Svc -StorageContext $StorageContext -DiagnosticsConfigurationPath $WadConfigXML此命令會啟用所有角色的 Azure 診斷 擴充功能。
範例 2：為指定的角色啟用 Azure 診斷 擴充功能
PS C:\> Set-AzureServiceDiagnosticsExtension -ServiceName $Svc -StorageContext $StorageContext -DiagnosticsConfigurationPath $WadConfigXML -Role "WebRole01"此命令會啟用指定角色 Azure 診斷 延伸模組。
參數
-CertificateThumbprint
指定要用來加密私人組態的憑證指紋。 此憑證必須已存在於證書存儲中。 如果您未指定憑證，此 Cmdlet 會建立憑證。
| 類型: | String |
| Position: | 3 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DiagnosticsConfiguration
指定 Azure 診斷 的組態陣列。
| 類型: | ExtensionConfigurationInput[] |
| Position: | 2 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DiagnosticsConfigurationPath
指定 Azure 診斷 的組態。 您可以使用下列命令來下載架構：
(Get-AzureServiceAvailableExtension -ExtensionName 'PaaSDiagnostics' -ProviderNamespace 'Microsoft.Azure.Diagnostics').PublicConfigurationSchema | Out-File -Encoding utf8 -FilePath 'WadConfig.xsd'
| 類型: | String |
| Position: | 9 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ExtensionId
指定延伸模組識別碼
| 類型: | String |
| Position: | 11 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-InformationAction
指定此 Cmdlet 如何回應資訊事件。
此參數可接受的值為：
- 繼續
- 忽略
- 詢問
- SilentlyContinue
- 停止
- 暫止
| 類型: | ActionPreference |
| 別名: | infa |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InformationVariable
指定資訊變數。
| 類型: | String |
| 別名: | iv |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Profile
指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。
| 類型: | AzureSMProfile |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Role
指定要指定 Azure 診斷 組態之角色的選擇性陣列。 如果您未指定此參數，診斷組態會套用為所有角色的預設組態。
| 類型: | String[] |
| Position: | 2 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ServiceName
指定部署的 Azure 服務名稱。
| 類型: | String |
| Position: | 0 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Slot
指定要修改之部署的環境。 此參數可接受的值為：生產或預備。
| 類型: | String |
| Position: | 1 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StorageAccountEndpoint
指定記憶體帳戶端點。
| 類型: | String |
| Position: | 7 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StorageAccountKey
指定記憶體帳戶金鑰。
| 類型: | String |
| Position: | 6 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StorageAccountName
指定記憶體帳戶名稱。
| 類型: | String |
| Position: | 5 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-StorageContext
指定 Azure 記憶體內容。
| 類型: | AzureStorageContext |
| Position: | 8 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ThumbprintAlgorithm
指定指紋哈希演算法，此演算法會搭配指紋來識別憑證。 此參數是選擇性的，預設值為sha1。
| 類型: | String |
| Position: | 4 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Version
指定延伸模組的版本。
| 類型: | String |
| Position: | 10 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-X509Certificate
指定 X.509 憑證，指定時會自動上傳至雲端服務，並用於加密擴充功能私人組態。
| 類型: | X509Certificate2 |
| Position: | 3 |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |