PowerShell kullanarak VM içgörülerini etkinleştirme

  • Makale

Bu makalede, PowerShell kullanarak Azure sanal makinelerinde VM içgörülerinin nasıl etkinleştirileceği açıklanır. Bu yordam aşağıdakiler için kullanılabilir:

  • Azure Sanal Makineler
  • Azure Sanal Makine Ölçek Kümeleri

Bu betik Log Analytics/Azure İzleme Aracısı (AMA) için VM uzantılarını ve gerekirse VM Analizler etkinleştirmek için Bağımlılık Aracısı'nı yükler. AMA eklenirse, sanal makineler ve sanal makine ölçek kümeleri ile bir Veri Toplama Kuralı (DCR) ve Kullanıcı Tarafından Atanan Yönetilen Kimlik (UAMI) de ilişkilendirilir.

Önemli

Eski Log Analytics aracısıAğustos 2024'e kadar kullanımdan kaldırılacaktır. Bu tarihten sonra, Microsoft artık Log Analytics aracısı için herhangi bir destek sağlamayacaktır. Verileri almaya devam etmek için Ağustos 2024'den önce Azure İzleyici aracısına geçiş yapın.

Not

Azure İzleyici Aracısı 1.10.1 sürümünde desteklenir.

Önkoşullar

Şunları yapmanız gerekir:

  • Azure İzleyici Aracısı ile ilgili önkoşullar için bkz. Azure İzleyici Aracısını Yönetme.
  • Etkinleştirdiğiniz sanal makinenin veya sanal makine ölçek kümesinin işletim sisteminin desteklendiğinden emin olmak için bkz . Desteklenen işletim sistemleri .
  • Azure İzleyici Aracısı için ağ yalıtımını etkinleştirmek için bkz. Özel Bağlantı kullanarak Azure İzleyici Aracısı için ağ yalıtımını etkinleştirme.

PowerShell betiği

Birden çok VM veya sanal makine ölçek kümesi için VM içgörülerini etkinleştirmek için Install-VM Analizler.ps1 PowerShell betiğini kullanın. Betik, Azure PowerShell Galerisi'ndan kullanılabilir. Bu betik, belirttiğiniz parametrelere göre sanal makineler veya sanal makine ölçek kümeleri aracılığıyla yinelenir. Betik, vm içgörülerini etkinleştirmek için kullanılabilir:

  • Aboneliğinizdeki her sanal makine ve sanal makine ölçek kümesi.
  • tarafından -ResourceGroupbelirtilen kapsamlı kaynak grupları.
  • tarafından -Namebelirtilen bir VM veya sanal makine ölçek kümesi. Joker karakterler kullanarak birden çok kaynak grubu, VM veya ölçek kümesi belirtebilirsiniz.

Uyumluluk diğer adları etkinken Az PowerShell modülü sürüm 1.0.0 veya üzerini Enable-AzureRM kullandığınızı doğrulayın. Sürümü bulmak için Get-Module -ListAvailable Az komutunu çalıştırın. Yükseltmek için bkz . Azure PowerShell modülünü yükleme. PowerShell'i yerel olarak çalıştırıyorsanız Azure ile bağlantı oluşturmak için komutunu çalıştırın Connect-AzAccount .

Betiğin bağımsız değişken ayrıntılarının ve örnek kullanımın listesi için komutunu çalıştırın Get-Help.

Get-Help Install-VMInsights.ps1 -Detailed

Azure İzleme Aracısı ve Bağımlılık Aracısı veya Log Analytics Aracısı kullanarak VM içgörülerini etkinleştirmek için betiği kullanın.

Azure İzleyici Aracısı'nı kullanarak VM içgörülerini etkinleştirdiğinizde, betik bir Veri Toplama Kuralı (DCR) ve Kullanıcı Tarafından Atanan Yönetilen Kimlik (UAMI) ile VM/Sanal Makine Ölçek Kümesi'ni ilişkilendirir. UAMI ayarları Azure İzleyici Aracısı uzantısına geçirilir.

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

Gerekli Bağımsız Değişkenler:

  • -SubscriptionId <String> Azure abonelik kimliği.
  • -DcrResourceId <String> Veri Toplama Kuralı (DCR) Azure kaynak kimliği tanımlayıcısı. Vm-Analizler ile etkinleştirilen VM'lere veya sanal makine ölçek kümelerine farklı aboneliklerden DCR'ler belirtebilirsiniz.
  • -UserAssignedManagedIdentityResourceGroup <String> Kullanıcı Tarafından Atanan Yönetilen Kimlik (UAMI) kaynak grubunun adı.
  • -UserAssignedManagedIdentityName <String> Kullanıcı Tarafından Atanan Yönetilen Kimliğin (UAMI) adı.

İsteğe Bağlı Bağımsız Değişkenler:

  • -ProcessAndDependencies Bağımlılık Aracısı'nı Azure İzleme Aracısı (AMA) ayarlarıyla eklemek için bu bayrağı ayarlayın. Belirtilmezse, yalnızca Azure monitoring Agent (AMA) eklenir.
  • -Name <String> Eklenecek VM'nin veya Sanal Makine Ölçek Kümesinin adı. Belirtilmezse, abonelik veya kaynak grubundaki tüm VM'ler ve Sanal Makine Ölçek Kümesi eklenir. Birden çok VM veya Sanal Makine Ölçek Kümeleri belirtmek için joker karakterler kullanın.
  • -ResourceGroup <String> Eklenecek VM'yi veya Sanal Makine Ölçek Kümesini içeren kaynak grubunun adı. Belirtilmezse, abonelikteki tüm VM'ler ve Sanal Makine Ölçek Kümesi eklenir. Birden çok kaynak grubu belirtmek için joker karakterler kullanın.
  • -PolicyAssignmentName <String> Yalnızca bu ilkeyle ilişkilendirilmiş VM'leri dahil edin. PolicyAssignmentName parametresi belirtildiğinde SubscriptionId parametresinin VM'leri dikkate alınır.
  • -TriggerVmssManualVMUpdate [<SwitchParameter>] Yükseltme ilkesi El ile olarak ayarlanmış bir ölçek kümesindeki VM örneklerinin güncelleştirmesini tetikleyin.
  • -WhatIf [<SwitchParameter>] Betikteki komutların beklenen etkisi hakkında bilgi edinin.
  • -Confirm [<SwitchParameter>] Betikteki her eylemi onaylayın.
  • -Approve [<SwitchParameter>]Listelenen VM'ler/Sanal Makine Ölçek Kümeleri için onay istemi olmadan başlamak üzere yüklemenin onayını sağlayın.

Betik ve -ResourceGroupiçin -Name joker karakterleri destekler. Örneğin, -Name vm* "vm" ile başlayan tüm VM'ler ve Sanal Makine Ölçek Kümeleri için VM içgörülerini etkinleştirir. Daha fazla bilgi için bkz . Windows PowerShell'de joker karakterler.

Örnek:

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

Çıktı aşağıdaki biçimdedir:

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

Uzantıların yüklü olup olmadığını görmek için Azure portalında VM/Sanal Makine Ölçek Kümenizi denetleyin veya aşağıdaki komutu kullanın:


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

Sonraki adımlar