Azure MCP-Servertools für Azure Advisor

Der Azure MCP-Server unterstützt Sie bei der Verwaltung Azure Advisor Ressourcen, einschließlich der Anwendung von Empfehlungen, dem Abrufen von Details, der Auflistung von Empfehlungen und der Bereitstellung von Zusammenfassungen in natürlicher Sprache.

Azure Advisor analysiert Ihre Azure Ressourcen und liefert personalisierte, umsetzbare Empfehlungen zur Optimierung von Kosten, Leistung, Zuverlässigkeit und Sicherheit. Weitere Informationen finden Sie in Azure Advisor Dokumentation.

Hinweis

Toolparameter: Die Azure MCP Server-Tools definieren Parameter für Daten, die sie zum Ausführen von Aufgaben benötigen. Einige dieser Parameter sind für jedes Tool spezifisch und werden hier dokumentiert. Andere Parameter sind global und werden von allen Tools gemeinsam genutzt. Weitere Informationen finden Sie unter Toolparameter.

Metadaten: Abrufen

Ruft Azure Advisor Metadaten für einen bestimmten Empfehlungstyp ab. Gibt den Anzeigenamen des Empfehlungstyps, die Kategorie, die Unterkategorie, die Auswirkung, die unterstützten Ressourcentypen, die Beschreibung, potenzielle Vorteile und Abhilfemaßnahmen zurück. Verwenden Sie die Metadaten, um die Empfehlung zu verstehen, ihre Auswirkungen zu bewerten und Korrekturschritte zu planen.

Beispiel-CLI-Befehl

azmcp advisor metadata get \
  --recommendation-type-id <recommendation-type-id> \
  [--language <language>]
Parameter Typ Erforderlich Beschreibung
recommendation-type-id string Ja Die stabile Advisor-Empfehlungstyp-ID (properties.recommendationTypeId) zum Nachschlagen im globalen Empfehlungsmetadatenkatalog. Diese ID ist der Join-Schlüssel, der gemeinsam mit den einzelnen Empfehlungen verwendet wird.
language string No Katalog-Gebietsschema zum Filtern (properties.language). Wird standardmäßig auf en festgelegt. Groß-/Kleinschreibung wird nicht beachtet. Unterstützte Werte: en, cs, de, fr, es, hu, id, ja, tr, zh-hans, zh-hant, it, ko, nl, pl, pt-br, pt-pt, ru, sv. Advisor akzeptiert regionsqualifizierte Tags wie en-US z. B. und ordnet sie der Basissprache (en) zu.

Hinweise für Anmerkungen im Tool:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich
❌ ✅ ❌ ✅ ❌ ❌

Metadaten: Liste

Listet Azure Advisor Empfehlungsmetadaten auf, die auch als Empfehlungstypen bezeichnet werden. Hilft Ihnen zu ermitteln, welche Empfehlungen Azure Advisor produzieren können, bevor Sie Ressourcen wie virtuelle Computer bereitstellen, auch wenn keine aktiven Empfehlungen vorhanden sind. Zeigt Außerdienststellungen des Advisor-Diensts an, die an, vor oder nach einem angegebenen Außerdienststellungsdatum erfolgen, und sucht Metadaten zur Dienstaußerdienststellung anhand der Service Health-Nachverfolgungs-ID. Unterstützt die Greenfield-Erkennung mit dem globalen Katalog des Azure Resource Graph und die Filterung nach Ressourcentypen für das Brownfield-Onboarding. Akzeptiert optionale Filter für Sprache, Ressourcentyp, Auswirkung, Kategorie, Unterkategorie, Nachverfolgungs-ID und Einstellungsdatum. Gibt lokalisierte Typ-IDs, Namen, Kategorien, Unterkategorien, Auswirkungen, Priorität, Beschreibungen, Vorteile, Aktionen, Geltungsbereich, Quellabfrage und Details zur Außerbetriebnahme des Diensts zurück. Sortiert Ergebnisse nach Auswirkungen von "Hoch" bis "Mittel" bis "Niedrig" und dann nach Anzeigename.

Beispiel-CLI-Befehl

azmcp advisor metadata list \
  [--language <language>] \
  [--resource-type <resource-type>] \
  [--impact <impact>] \
  [--category <category>] \
  [--sub-category <sub-category>] \
  [--tracking-id <tracking-id>] \
  [--retirement-date <retirement-date>]
Parameter Typ Erforderlich Beschreibung
language string No Sprache für lokalisierte Empfehlungsmetadaten. Standardwert ist Englisch (en). Unterstützte Katalogsprachen sind en, cs, es, de, fr, hu, id, it, ja, nl, ko, pl, pt-BR, pt-PT, sv, tr, ru, zh-Hans und zh-Hant. Regionale Varianten werden, sofern verfügbar, einer unterstützten Basissprache zugeordnet, beispielsweise en-US zu en und fr-CA zu fr; gebietsspezifische Katalogsprachen bleiben voneinander getrennt.
resource-type string No Optionaler exakter Azure-Ressourcentypfilter, z. B. microsoft.compute/virtualmachines. Verwenden Sie es während des Brownfield-Onboardings, um Empfehlungstypen zu ermitteln, die für diesen Ressourcentyp gelten. Bei dem Filter wird die Groß-/Kleinschreibung nicht beachtet.
impact string No Optionaler Filter für Empfehlungsauswirkungen. Zulässige Werte sind High, Mediumoder Low. Der Filter berücksichtigt die Groß-/Kleinschreibung nicht. Standardmäßig werden die Ergebnisse in High, Mediumund dann Low in Reihenfolge angezeigt.
category string No Optionaler exakter Advisor-Kategoriefilter. Zulässige Werte sind Cost, HighAvailability, Security, Performance und OperationalExcellence. Der Filter berücksichtigt die Groß-/Kleinschreibung nicht.
sub-category string No Optionaler exakter Empfehlungsunterkategoriefilter. Bei dem Filter wird die Groß-/Kleinschreibung nicht beachtet. Bekannte Katalogwerte sind ComputeOptimization, DataPerformance, DataProtectionAndRecovery, EfficiencyOptimization, FailureMitigation, GovernanceAndCompliance, MonitoringAndAlerting, Other, NetworkOptimization, Personalized, RegionalResiliency, SafeAndSecureDeployment, Reservations, SavingsPlan, ServiceUpgradeAndRetirement, StorageOptimization, Scalability, UsageOptimization und ZoneResiliency. Der Katalog kann Werte im Laufe der Zeit hinzufügen, sodass das Tool andere Unterkategorien akzeptiert.
tracking-id string No Optionaler Filter für die genaue Service Health-Tracking-ID, z. B. QNY1-HB8. Der Filter unterscheidet nicht zwischen Groß- und Kleinschreibung und wird innerhalb von ServiceUpgradeAndRetirement-Metadaten angewendet. Sie können auslassen --sub-category, aber keinen anderen Wert angeben.
retirement-date string No Optionaler Filter für das Dienst-Außerbetriebnahmedatum im Format <operator>:<yyyy-MM-dd>, z. B. ge:2026-03-31. Unterstützte Operatoren sind eq, lt, le, , gtund ge. Gilt nur für die ServiceUpgradeAndRetirement Unterkategorie. Sie können auslassen --sub-category, aber keinen anderen Wert angeben.

Hinweise für Anmerkungen im Tool:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich
❌ ✅ ❌ ✅ ❌ ❌

Empfehlung: Anwenden

Hilft Ihnen, Azure-Advisor-Empfehlungen in Infrastructure-as-Code-Dateien (IaC) umzusetzen, z. B. in Azure Resource Manager (ARM)-Vorlagen und Terraform-Konfigurationen. Sie gibt Regeln zurück, die auf die IaC-Datei angewendet werden sollen.

Beispiel-CLI-Befehl

azmcp advisor recommendation apply \
  --resource <resource>
Parameter Typ Erforderlich Beschreibung
resource string Ja Der Azure-Ressourcentyp, für den IaC-Dateiregeln abgerufen werden sollen. Verfügbare Optionen: aad_domainservices, apimanagement_service, cognitiveservices_accounts, compute_virtualmachines, compute_virtualmachinescalesets, containerregistry_registries, containerservice_managedclusters, dbforpostgresql_flexibleservers, documentdb_databaseaccounts, keyvault_vaults, kubernetes_connectedclusters, kubernetesconfiguration_extensions, netapp_volumes, network_applicationgatewaywebapplicationfirewallpolicies, network_expressrouteports, network_frontdoorwebapplicationfirewallpolicies, sql_managedinstances, storage_storageaccounts, web_serverfarms, web_staticsites

Hinweise für Anmerkungen im Tool:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich
❌ ✅ ❌ ✅ ❌ ❌

Empfehlung: Liste

Listet einzelne Azure Advisor Empfehlungen für ein Abonnement auf, wobei pro Empfehlung ein Datensatz zurückgegeben wird. Verwenden Sie diesen Befehl nur, um Empfehlungsinhalte und Details anzuzeigen. Verwenden Sie advisor recommendation summary stattdessen für Aggregat-, Bewertungs-, Vergleichs- oder Zählungsfragen. Gibt nur aktive Empfehlungen mit Status New zurück und schließt verworfene und verschobene Empfehlungen aus. Unterstützt optionale Filter für Kategorie, Auswirkung, Ressourcentyp, Ressource und Freitextsuche. Ein top-Parameter begrenzt die Anzahl der zurückgegebenen Elemente, mit einem Standardwert von 50 und einem Maximum von 100. Da der Befehl höchstens 100 Datensätze zurückgibt, kann die Verwendung dieser Ergebnisse für Aggregatberechnungen den Gesamtwert unterschätzen.

Beispiel-CLI-Befehl

azmcp advisor recommendation list \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Parameter Typ Erforderlich Beschreibung
category string No Filtern von Empfehlungen nach Kategorie (z. B. Security, , Cost, Performance, HighAvailability). OperationalExcellence Exakte Übereinstimmung ohne Beachtung der Groß- und Kleinschreibung.
impact string No Filtern von Empfehlungen nach geschäftlichen Auswirkungen (High, Mediumoder Low). Exakte Übereinstimmung ohne Beachtung der Groß- und Kleinschreibung.
resource-type string No Filtern Sie Empfehlungen nach betroffenen Azure-Ressourcentypen (z. B. Microsoft.Storage/storageAccounts). Exakte Übereinstimmung ohne Beachtung der Groß- und Kleinschreibung.
resource string No Filtern Sie Empfehlungen nach dem betroffenen Ressourcennamen oder der vollständigen ARM-Ressourcen-ID. Übereinstimmung mit Teilzeichenfolge ohne Berücksichtigung der Groß-/Kleinschreibung.
search string No Wendet einen Freitextfilter auf den Text des Empfehlungsproblems an (Teilzeichenfolgenübereinstimmung ohne Berücksichtigung der Groß-/Kleinschreibung). Verwenden Sie dies immer, wenn eine Anfrage einen thematischen Ausdruck wie related to Microsoft Foundry, about encryption, mentioning right-size oder for Key Vault enthält. Extrahieren Sie die aussagekräftigen Substantive aus der Phrase (z. B. Foundry, encrypt, right-size, Key Vault) und übergeben Sie sie hier.
top string No Maximale Anzahl der zurückzugebenden Elemente. Für list: Der Standardwert ist 50 bei einem serverseitigen Bereich von 1-100. Für summary: optionale Anzeigeobergrenze für die Anzahl der zurückgegebenen Buckets (Standardwert für alle). TotalRecommendations spiegelt unabhängig von --top immer die vollständige gefilterte Menge wider.
resource-group string No Der Azure-Ressourcengruppenname.

Hinweise für Anmerkungen im Tool:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich
❌ ✅ ❌ ✅ ❌ ❌

Empfehlung: Zusammenfassung

Dieser Befehl aggregiert aktive Azure Advisor Empfehlungen mit Status New und gibt die Anzahl pro Bucket sowie eine genaue Summe zurück. Verwenden Sie diesen Befehl für Aggregat-, Rangfolge-, Vergleichs- und Zählungsfragen. Filter gelten vor Aggregation. Gruppieren Von Ergebnissen nach recommendation-type, , category, impactoder resource-type. Die Standardgruppierung ist category, die übergeordnete Themen wie Kosten, Sicherheit und Zuverlässigkeit anzeigt. Der top Parameter beschränkt die angezeigten Buckets, spiegelt jedoch TotalRecommendations immer die vollständige gefilterte Population wider. Der Befehl behält den Unknown Bucket als Endergebnis bei. Fügen Sie ihn als letzte Zeile ein, wenn Sie Gruppen in einer Tabelle anzeigen.

Beispiel-CLI-Befehl

azmcp advisor recommendation summary \
  [--group-by <group-by>] \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
Parameter Typ Erforderlich Beschreibung
group-by string No Feld, nach dem die Zusammenfassung gruppiert wird. Einer von: recommendation-type, , categoryimpact, resource-type. Standardmäßig wird category verwendet, wodurch die übergeordneten Themen (Kosten, Sicherheit, Zuverlässigkeit und mehr) angezeigt werden, sodass Eingaben wie summarize the key themes from my Advisor recommendations funktionieren, ohne einen Bereich benennen zu müssen.
category string No Filtern von Empfehlungen nach Kategorie (z. B. Security, , Cost, Performance, HighAvailability). OperationalExcellence Exakte Übereinstimmung ohne Beachtung der Groß- und Kleinschreibung.
impact string No Filtern von Empfehlungen nach geschäftlichen Auswirkungen (High, Mediumoder Low). Exakte Übereinstimmung ohne Beachtung der Groß- und Kleinschreibung.
resource-type string No Filtern Sie Empfehlungen nach betroffenen Azure-Ressourcentypen (z. B. Microsoft.Storage/storageAccounts). Exakte Übereinstimmung ohne Beachtung der Groß- und Kleinschreibung.
resource string No Filtern Sie Empfehlungen nach dem betroffenen Ressourcennamen oder der vollständigen ARM-Ressourcen-ID. Übereinstimmung mit Teilzeichenfolge ohne Berücksichtigung der Groß-/Kleinschreibung.
search string No Freitextfilter, der auf den Text des Empfehlungsproblems angewendet wird (Teilzeichenfolgenabgleich ohne Berücksichtigung der Groß-/Kleinschreibung). Verwenden Sie diesen Filter, wenn Ihre Anfrage einen thematischen Ausdruck wie related to Microsoft Foundry, about encryption, mentioning right-size oder for Key Vault enthält. Extrahieren Sie die hervorstechenden Substantive aus der Wortgruppe (zum Beispiel Foundry, encrypt, right-size, Key Vault) und geben Sie sie hier ein.
top string No Maximale Anzahl der zurückzugebenden Elemente. Für list: standardmäßig 50, auf 1–100 begrenzt (serverseitiges Limit). Für summary: optionale Anzeigeobergrenze für die Anzahl der zurückgegebenen Buckets (Standardwert für alle). TotalRecommendations spiegelt unabhängig von --top immer die vollständige gefilterte Menge wider.
resource-group string No Der Azure-Ressourcengruppenname.

Hinweise für Anmerkungen im Tool:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich
❌ ✅ ❌ ✅ ❌ ❌

Verwandte Inhalte

  • Last updated on