共用方式為

MMA 探索和移除公用程式

  • 發行項

將機器移轉至 Azure 監視器代理程式 (AMA) 之後，您必須移除 Log Analytics 代理程式 (也稱為 Microsoft 管理代理程式或 MMA)，以避免重複記錄。 Azure 租用戶安全性解決方案 (AzTS) MMA 探索和移除公用程式可以從租用戶集中移除 Azure 虛擬機器 (VM)、Azure 虛擬機擴展集和 Azure Arc 伺服器的 MMA 擴充功能。

注意

此公用程式可用來探索和移除 MMA 延伸模組。 這不會移除 OMS 擴充功能，您必須在這裡執行清除腳本來手動移除 OMS： 清除 Linux 代理程式

公用程式可在兩個步驟中運作：

  1. 探索：公用程式會建立已安裝 MMA 的所有機器清查。 建議您在執行公用程式時，不要使用 MMA 擴充功能建立任何新的 VM、虛擬機器擴展集或 Azure Arc 伺服器。

  2. 移除：公用程式會選取同時具有 MMA 和 AMA 的電腦，並移除 MMA 擴充功能。 您可以在驗證電腦清單之後停用此步驟並加以執行。 您可以選擇從只有 MMA 的機器中移除擴充功能，但建議您先將所有相依性移轉至 AMA，然後移除 MMA。

必要條件

使用 PowerShell 擴充功能，在 Visual Studio Code 執行所有安裝步驟。 您需要：

  • Windows 10 或更新版本，或 Windows Server 2019 或更新版本。
  • PowerShell 5.0 或更新版本。 執行 $PSVersionTable 以檢查版本。
  • PowerShell。 語言必須設定為 FullLanguage 模式。 在 PowerShell 中執行 $ExecutionContext.SessionState.LanguageMode 來檢查模式。 如需詳細資訊，請參閱 PowerShell 參考。
  • Bicep。 安裝指令碼會使用 Bicep 將安裝自動化。 執行 bicep --version 檢查安裝狀態。 如需詳細資訊，請參閱安裝 Bicep 工具。
  • 具有讀取者、虛擬機器參與者，以及 Azure Arc ScVmm VM 參與者目標範圍存取權的使用者指派的受控識別。
  • 新的資源群組，其中包含安裝自動化自動建立的所有 Azure 資源。
  • 所設定範圍的適當權限。 若要將補救使用者指派的受控識別授與目標範圍上先前提及的角色，您必須擁有使用者存取系統管理員或擁有者權限。 例如，如果您要安裝特定訂用帳戶的設定，您必須在該訂用帳戶上擁有使用者存取系統管理員角色指派，讓指令碼可以提供補救使用者指派受控識別的權限。

已建立的資源

拿掉工具會建立 resouce 群組，並建立下列重新搜尋以管理代理程式移除。 其中有些可能會有 Azure 成本。

下載部署套件

部署套件包含：

  • Bicep 範本，其中包含您在安裝期間建立的資源組態詳細資料。
  • 部署安裝令碼，提供 Cmdlet 來執行安裝。

安裝套件：

  1. 移至 AzTS-docs GitHub 存放庫。 將部署套件檔案 AzTSMMARemovalUtilityDeploymentFiles.zip 下載到本機電腦。

  2. 將 .zip 檔案解壓縮至本機資料夾位置。

  3. 使用此指令碼解除封鎖檔案：

    Get-ChildItem -Path "<Extracted folder path>" -Recurse | Unblock-File

設定公用程式

  1. 移至部署資料夾並載入合併安裝指令碼。 您必須擁有訂用帳戶的擁有者存取權。

    CD "<LocalExtractedFolderPath>\AzTSMMARemovalUtilityDeploymentFiles"
. ".\MMARemovalUtilityConsolidatedSetup.ps1"

  2. 使用下列 PowerShell 命令登入 Azure 帳戶：

    $TenantId = "<TenantId>"
Connect-AzAccount -Tenant $TenantId

  3. 執行安裝指令碼以執行下列作業：

    • 安裝必要的 Az 模組。
    • 設定補救使用者指派的受控識別。
    • 根據使用者喜好設定，提示並收集使用量遙測收集的上線詳細資料。
    • 建立或更新資源群組。
    • 使用指派的受控識別建立或更新資源。
    • 建立或更新監視儀表板。
    • 設定目標範圍。
    $SetupInstallation = Install-AzTSMMARemovalUtilitySolutionConsolidated `
         -RemediationIdentityHostSubId <MIHostingSubId> `
         -RemediationIdentityHostRGName <MIHostingRGName> `
         -RemediationIdentityName <MIName> `
         -TargetSubscriptionIds @("<SubId1>","<SubId2>","<SubId3>") `
         -TargetManagementGroupNames @("<MGName1>","<MGName2>","<MGName3>") `
         -TenantScope `
         -SubscriptionId <HostingSubId> `
         -HostRGName <HostingRGName> `
         -Location <Location> `
         -AzureEnvironmentName <AzureEnvironmentName>

    指令碼包含下列參數：

    參數名稱 描述 必要
    RemediationIdentityHostSubId 用來建立補救資源的訂用帳戶識別碼。 Yes
    RemediationIdentityHostRGName 要建立補救的新資源群組名稱。 預設為 AzTS-MMARemovalUtility-RG。 No
    RemediationIdentityName 補救受控識別的名稱。 Yes
    TargetSubscriptionIds 要執行的目標訂用帳戶識別碼清單。 No
    TargetManagementGroupNames 要執行的目標管理群組名稱清單。 No
    TenantScope 透過租用戶識別碼指派角色的租用戶範圍。 No
    SubscriptionId 安裝設置的訂用帳戶識別碼。 Yes
    HostRGName 建立補救受控識別的新資源群組名稱。 預設值為 AzTS-MMARemovalUtility-Host-RG。 No
    Location 建立安裝程式的位置網域控制站。 預設值為 EastUS2。 No
    AzureEnvironmentName 安裝解決方案的 Azure 環境：AzureCloud 或 AzureGovernmentCloud。 預設值為 AzureCloud。 No

執行公用程式

Update-AzTSMMARemovalUtilityDiscoveryTrigger ` 
    -SubscriptionId <HostingSubId> `
    -ResourceGroupName <HostingRGName> `
    -StartScopeResolverAfterMinutes 60 `
    -StartExtensionDiscoveryAfterMinutes 30

指令碼包含下列參數：

參數名稱 描述 必要
SubscriptionId 您安裝公用程式的訂用帳戶識別碼。 Yes
ResourceGroupName 您安裝公用程式的資源群組名稱。 Yes
StartScopeResolverAfterMinutes 時間，以分鐘為單位，執行解析程式前的等候時間。 是 (不可與 -StartScopeResolverImmediately 同時存在)
StartScopeResolverImmediately 要立即執行解析程式的指標。 是 (不可與 -StartScopeResolverAfterMinutes 同時存在)
StartExtensionDiscoveryAfterMinutes 時間，以分鐘為單位，等候執行探索前的時間 (應在解析程式完成之後)。 是 (不可與 -StartExtensionDiscoveryImmediatley 同時存在)
StartExtensionDiscoveryImmediatley 要立即執行延伸模組探索的指標。 是 (不可與 -StartExtensionDiscoveryAfterMinutes 同時存在)