Share via


Virtuálisgép-elemzések engedélyezése a PowerShell használatával

Ez a cikk azt ismerteti, hogyan engedélyezheti a virtuálisgép-elemzéseket azure-beli virtuális gépeken a PowerShell használatával. Ez az eljárás a következő célokra használható:

  • Azure Virtual Machines
  • Azure Virtual Machine Scale Sets

Ez a szkript telepíti a Log Analytics/Azure Monitoring Agent (AMA) virtuálisgép-bővítményeit, és szükség esetén a függőségi ügynököt a virtuális gépek Elemzések engedélyezéséhez. Az AMA előkészítésekor egy adatgyűjtési szabály (DCR) és egy felhasználó által hozzárendelt felügyelt identitás (UAMI) is társítva van a virtuális gépekhez és a virtuálisgép-méretezési csoportokhoz.

Fontos

Az örökölt Log Analytics-ügynök2024 augusztusára megszűnik. Ezt követően a Microsoft a továbbiakban nem nyújt támogatást a Log Analytics-ügynök számára. 2024 augusztusa előtt migráljon az Azure Monitor-ügynökbe az adatok betöltésének folytatásához.

Feljegyzés

Az Azure Monitor Agent az 1.10.1-es verziótól támogatott.

Előfeltételek

A következőkre van szüksége:

PowerShell-szkript

Ha több virtuális gép vagy virtuálisgép-méretezési csoport virtuálisgép-elemzéseit szeretné engedélyezni, használja az Install-VM PowerShell-szkriptet Elemzések.ps1. A szkript az Azure PowerShell-galéria érhető el. Ez a szkript a megadott paramétereknek megfelelően végigvezeti a virtuális gépeket vagy a virtuálisgép-méretezési csoportokat. A szkript a következő virtuálisgép-elemzések engedélyezésére használható:

  • Az előfizetésben lévő összes virtuális gép és virtuálisgép-méretezési csoport.
  • A megadott hatókörű erőforráscsoportok -ResourceGroup.
  • A megadott virtuálisgép-vagy virtuálisgép-méretezési -Namecsoport. Helyettesítő karakterek használatával több erőforráscsoportot, virtuális gépet vagy méretezési csoportot is megadhat.

Ellenőrizze, hogy az Az PowerShell-modul 1.0.0-s vagy újabb verzióját használja-e, és Enable-AzureRM hogy engedélyezve vannak-e a kompatibilitási aliasok. A verzió azonosításához futtassa a következőt: Get-Module -ListAvailable Az. A frissítéshez tekintse meg az Azure PowerShell-modul telepítését ismertető témakört. Ha helyileg futtatja a PowerShellt, futtassa Connect-AzAccount a kapcsolatot az Azure-ral.

A szkript argumentumadatainak és a példahasználatnak a listájához futtassa a következőt Get-Help: .

Get-Help Install-VMInsights.ps1 -Detailed

A szkripttel engedélyezheti a virtuálisgép-elemzéseket az Azure Monitoring Agent és a Függőségi ügynök vagy a Log Analytics-ügynök használatával.

Ha az Azure Monitor Agent használatával engedélyezi a virtuálisgép-elemzéseket, a szkript egy adatgyűjtési szabályt (DCR) és egy felhasználó által hozzárendelt felügyelt identitást (UAMI) társít a virtuálisgép-/virtuálisgép-méretezési csoporthoz. Az UAMI-beállításokat a rendszer átadja az Azure Monitor Agent bővítménynek.

Install-VMInsights.ps1 -SubscriptionId <SubscriptionId> `
[-ResourceGroup <ResourceGroup>] `
[-ProcessAndDependencies ] `
[-Name <VM or Virtual Machine Scale Set name>] `
-DcrResourceId <DataCollectionRuleResourceId> `
-UserAssignedManagedIdentityName <UserAssignedIdentityName> `
-UserAssignedManagedIdentityResourceGroup <UserAssignedIdentityResourceGroup> 

Kötelező argumentumok:

  • -SubscriptionId <String> Azure-előfizetés azonosítója.
  • -DcrResourceId <String> Adatgyűjtési szabály (DCR) Azure-erőforrás-azonosító. A különböző előfizetések DCRs-eit a virtuális gépekre vagy a virtuálisgép-Elemzések engedélyezve lévő virtuálisgép-méretezési csoportokra adhatja meg.
  • -UserAssignedManagedIdentityResourceGroup <String> A felhasználó által hozzárendelt felügyelt identitás (UAMI) erőforráscsoport neve.
  • -UserAssignedManagedIdentityName <String> A felhasználó által hozzárendelt felügyelt identitás (UAMI) neve.

Választható argumentumok:

  • -ProcessAndDependencies Állítsa be ezt a jelzőt úgy, hogy az Azure Monitoring Agent (AMA) beállításaival előkészítse a függőségi ügynököt. Ha nincs megadva, csak az Azure Monitoring Agent (AMA) lesz előkészítve.
  • -Name <String> Az előkészítésre kerülő virtuális gép vagy virtuálisgép-méretezési csoport neve. Ha nincs megadva, a rendszer az előfizetésben vagy erőforráscsoportban lévő összes virtuális gépet és virtuálisgép-méretezési csoportot előkészíti. Használjon helyettesítő karaktereket több virtuális gép vagy virtuálisgép-méretezési csoport megadásához.
  • -ResourceGroup <String> Az előkészítendő virtuális gépet vagy virtuálisgép-méretezési csoportot tartalmazó erőforráscsoport neve. Ha nincs megadva, az előfizetésben lévő összes virtuális gép és virtuálisgép-méretezési csoport elő van készítve. Helyettesítő karakterek használatával adjon meg több erőforráscsoportot.
  • -PolicyAssignmentName <String> Csak a szabályzathoz társított virtuális gépeket foglalja magában. A PolicyAssignmentName paraméter megadásakor a rendszer figyelembe veszi az SubscriptionId paraméter virtuális gépek részét.
  • -TriggerVmssManualVMUpdate [<SwitchParameter>] Aktiválja a virtuálisgép-példányok frissítését egy olyan méretezési csoportban, amelynek frissítési szabályzata manuálisra van állítva.
  • -WhatIf [<SwitchParameter>] Információt kaphat a parancsok várható hatásáról a szkriptben.
  • -Confirm [<SwitchParameter>] Erősítse meg a szkript minden egyes műveletét.
  • -Approve [<SwitchParameter>] Adja meg a telepítés megkezdéséhez szükséges jóváhagyást a felsorolt virtuális gép/virtuálisgép-méretezési csoportok megerősítő kérése nélkül.

A szkript támogatja a helyettesítő karaktereket és -ResourceGroupa -Name . Például engedélyezi a -Name vm* virtuálisgép-elemzéseket az összes virtuális géphez és virtuálisgép-méretezési csoporthoz, amelyek a "vm" kezdetűek. További információ: Helyettesítő karakterek a Windows PowerShellben.

Példa:

Install-VMInsights.ps1 -SubscriptionId 12345678-abcd-abcd-1234-12345678 `
-ResourceGroup rg-AMAPowershell  `
-ProcessAndDependencies  `
-Name vmAMAPowershellWindows `
-DcrResourceId /subscriptions/12345678-abcd-abcd-1234-12345678/resourceGroups/rg-AMAPowershell/providers/Microsoft.Insights/dataCollectionRules/MSVMI-ama-vmi-default-dcr `
-UserAssignedManagedIdentityName miamatest1  `
-UserAssignedManagedIdentityResourceGroup amapowershell

A kimenet formátuma a következő:

Name                                     Account                               SubscriptionName                      Environment                          TenantId
----                                     -------                               ----------------                      -----------                          --------
AzMon001 12345678-abcd-123…              MSI@9876                              AzMon001                              AzureCloud                           abcd1234-9876-abcd-1234-1234abcd5648

Getting list of VMs or VM Scale Sets matching specified criteria.
VMs and Virtual Machine Scale Sets matching selection criteria :

ResourceGroup : rg-AMAPowershell
  vmAMAPowershellWindows


Confirm
Continue?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): 

(rg-AMAPowershell) : Assigning roles

(rg-AMAPowershell) vmAMAPowershellWindows : Assigning User Assigned Managed Identity edsMIAMATest
(rg-AMAPowershell) vmAMAPowershellWindows : Successfully assigned User Assigned Managed Identity edsMIAMATest
(rg-AMAPowershell) vmAMAPowershellWindows : Data Collection Rule Id /subscriptions/12345678-abcd-abcd-1234-12345678/resourceGroups/rg-AMAPowershell/providers/Microsoft.Insights/dataCollectionRules/MSVMI-ama-vmi-default-dcr already associated with the VM.
(rg-AMAPowershell) vmAMAPowershellWindows : Extension AzureMonitorWindowsAgent, type = Microsoft.Azure.Monitor.AzureMonitorWindowsAgent already installed. Provisioning State : Succeeded
(rg-AMAPowershell) vmAMAPowershellWindows : Installing/Updating extension AzureMonitorWindowsAgent, type = Microsoft.Azure.Monitor.AzureMonitorWindowsAgent
(rg-AMAPowershell) vmAMAPowershellWindows : Successfully installed/updated extension AzureMonitorWindowsAgent, type = Microsoft.Azure.Monitor.AzureMonitorWindowsAgent
(rg-AMAPowershell) vmAMAPowershellWindows : Installing/Updating extension DA-Extension, type = Microsoft.Azure.Monitoring.DependencyAgent.DependencyAgentWindows
(rg-AMAPowershell) vmAMAPowershellWindows : Successfully installed/updated extension DA-Extension, type = Microsoft.Azure.Monitoring.DependencyAgent.DependencyAgentWindows
(rg-AMAPowershell) vmAMAPowershellWindows : Successfully onboarded VM insights

Summary :
Total VM/VMSS to be processed : 1
Succeeded : 1
Skipped : 0
Failed : 0
VMSS Instance Upgrade Failures : 0

Ellenőrizze a virtuálisgép-/virtuálisgép-méretezési csoportot az Azure Portalon, és ellenőrizze, hogy telepítve vannak-e a bővítmények, vagy használja a következő parancsot:


az vm extension list --resource-group <resource group> --vm-name <VM name>  -o table 


Name                      ProvisioningState    Publisher                                   Version    AutoUpgradeMinorVersion
------------------------  -------------------  ------------------------------------------  ---------  -------------------------
AzureMonitorWindowsAgent  Succeeded            Microsoft.Azure.Monitor                     1.16       True
DA-Extension              Succeeded            Microsoft.Azure.Monitoring.DependencyAgent  9.10       True

Következő lépések