Azure MCP-Servertools für Azure Advisor

Mit dem Azure MCP-Server können Sie Azure Advisor Empfehlungen mithilfe von Eingabeaufforderungen in natürlicher Sprache verwalten. Sie können Empfehlungen anwenden, auflisten und zusammenfassen.

Azure Advisor ist ein Azure Dienst, der Empfehlungen zur Optimierung von Zuverlässigkeit, Sicherheit, Leistung, Betrieblicher Exzellenz und Kosten bietet. 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.

Empfehlung: anwenden

Wenden Sie die Empfehlungen von Azure Advisor auf Infrastructure-as-Code-Dateien (IaC) an, z. B. auf Azure Resource Manager-Vorlagen und Terraform-Konfigurationen. Sie geben mit --resource einen Azure-Ressourcentyp an, und das Tool liefert die Advisor-Regeln, die Sie auf Ihre IaC-Datei anwenden können, um Kosten, Leistung, Zuverlässigkeit oder Sicherheit zu verbessern.

Beispiel-CLI-Befehl

azmcp advisor recommendation apply \
  --resource <resource>
Parameter Type Erforderlich Beschreibung
resource Schnur Yes Der Azure-Ressourcentyp, für den Regeln zum Anwenden auf eine IaC-Datei 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

Abrufen einzelner Azure Advisor Empfehlungsdatensätze, eine Zeile pro Empfehlung, für ein Abonnement. Sie erhalten nur aktive Empfehlungen mit Status New. Abgelehnte und verschobene Empfehlungen werden ausgeschlossen. Verwenden Sie Filter für Kategorie, Auswirkung, Ressourcentyp, Ressource und Suche, um Ergebnisse einzugrenzen. Der obere Parameter begrenzt die Anzahl der zurückgegebenen Elemente; sie ist standardmäßig auf 50 festgelegt und hat maximal 100. Die Ergebnisse sind auf 100 Elemente begrenzt und können unterzählt werden, wenn Sie Aggregate oder Zählungen mit voller Population benötigen.

Beispiel-CLI-Befehl

azmcp advisor recommendation list \
  [--resource-group <resource-group>] \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>]
Parameter Type Erforderlich Beschreibung
category Schnur No Filtern von Empfehlungen nach Kategorie (z. B. Security, , Cost, Performance, HighAvailability). OperationalExcellence Exakte Übereinstimmung ohne Beachtung der Groß- und Kleinschreibung.
impact Schnur No Filtern von Empfehlungen nach geschäftlichen Auswirkungen (High, Mediumoder Low). Exakte Übereinstimmung ohne Beachtung der Groß- und Kleinschreibung.
resource Schnur No Filtern Sie Empfehlungen nach dem betroffenen Ressourcennamen oder der vollständigen ARM-Ressourcen-ID. Übereinstimmung mit Teilzeichenfolge ohne Berücksichtigung der Groß-/Kleinschreibung.
resource-type Schnur No Filtern Sie Empfehlungen nach betroffenen Azure-Ressourcentypen (z. B. Microsoft.Storage/storageAccounts). Exakte Übereinstimmung ohne Beachtung der Groß- und Kleinschreibung.
search Schnur No Freitextfilter, der auf den Text des Empfehlungsproblems angewendet wird (Teilzeichenfolgenabgleich ohne Berücksichtigung der Groß-/Kleinschreibung). Verwenden Sie dies immer dann, wenn die Anfrage des Benutzers eine thematische Formulierung wie „im Zusammenhang mit Microsoft Foundry“, „über Verschlüsselung“, „in der „right-size“ erwähnt wird“ oder „für Key Vault“ enthält. Extrahieren Sie die wesentlichen Substantive aus der Phrase (zum Beispiel Foundry, encrypt, right-size, Key Vault) und übergeben Sie sie hier.
top Schnur 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 oben immer die vollständige gefilterte Population wider.
resource-group Schnur No Der Name der Azure-Ressourcengruppe. Die Ressourcengruppe ist ein logischer Container für Azure-Ressourcen.

Hinweise für Anmerkungen im Tool:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich

Empfehlung: Zusammenfassung

Aggregiert Azure Advisor Empfehlungen und gibt die Anzahl pro Bucket und eine echte Summe zurück. Das Tool beantwortet Anzahl, Rangfolge und Verteilungsfragen über Ihre aktiven Empfehlungen, z. B. "wie viele", "Top N", "welches X die meisten hat", "Aufschlüsselung nach Feld", "Verteilung von" und "Anzahl der" Abfragen.

Beispiel-CLI-Befehl

azmcp advisor recommendation summary \
  [--resource-group <resource-group>] \
  [--group-by <group-by>] \
  [--top <top>] \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>]
Parameter Type Erforderlich Beschreibung
category Schnur No Filtern von Empfehlungen nach Kategorie (z. B. Security, , Cost, Performance, HighAvailability). OperationalExcellence Exakte Übereinstimmung ohne Beachtung der Groß- und Kleinschreibung.
group-by Schnur No Optionales Feld, nach dem die Zusammenfassung gruppiert wird. Einer von: recommendation-type, , categoryimpact, resource-type. Wird category weggelassen, wird standardmäßig dieser Wert verwendet, wodurch die übergeordneten Themen (Kosten, Sicherheit, Zuverlässigkeit und mehr) angezeigt werden, sodass Eingabeaufforderungen wie „die wichtigsten Themen aus meinen Advisor-Empfehlungen zusammenfassen“ funktionieren, ohne ein Feld benennen zu müssen.
impact Schnur No Filtern von Empfehlungen nach geschäftlichen Auswirkungen (High, Mediumoder Low). Exakte Übereinstimmung ohne Berücksichtigung der Groß-/Kleinschreibung.
resource Schnur No Filtern Sie Empfehlungen nach dem betroffenen Ressourcennamen oder der vollständigen ARM-Ressourcen-ID. Übereinstimmung mit Teilzeichenfolge ohne Berücksichtigung der Groß-/Kleinschreibung.
resource-type Schnur No Empfehlungen nach betroffenem Azure-Ressourcentyp filtern (z. B. Microsoft.Storage/storageAccounts). Exakte Übereinstimmung ohne Beachtung der Groß- und Kleinschreibung.
search Schnur No Freitextfilter, der auf den Text des Empfehlungsproblems angewendet wird (Teilzeichenfolgenübereinstimmung ohne Beachtung der Groß-/Kleinschreibung). Verwenden Sie dies immer dann, wenn die Anfrage des Benutzers eine thematisch einschlägige Formulierung enthält, etwa „im Zusammenhang mit Microsoft Foundry“, „zur Verschlüsselung“, „mit Erwähnung der richtigen Größe“ oder „für Key Vault“. Extrahieren Sie die wesentlichen Substantive aus der Phrase (zum Beispiel Foundry, encrypt, right-size, Key Vault) und übergeben Sie sie hier.
top Schnur No Maximale Anzahl der zurückzugebenden Elemente. Für list: standardmäßig 50, begrenzt auf 1-100 (serverseitige Grenze). Für summary: optionale Anzeigeobergrenze für die Anzahl der zurückgegebenen Buckets (Standardwert für alle). TotalRecommendations spiegelt unabhängig von oben immer die vollständige gefilterte Population wider.
resource-group Schnur No Der Name der Azure-Ressourcengruppe. Die Ressourcengruppe ist ein logischer Container für Azure-Ressourcen.

Hinweise für Anmerkungen im Tool:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich

Empfehlungstyp: Liste

Listen Sie den Katalog der Azure Advisor Empfehlungstypen auf. Die Ergebnisse umfassen die Empfehlungskategorie, die Auswirkung, den zielbezogenen Ressourcentyp und die Unterkategorie. Ergebnisse sortieren nach Auswirkungen (High, Medium, Low), sodass die wichtigsten Empfehlungen zuerst angezeigt werden.

Beispiel-CLI-Befehl

azmcp advisor recommendation-type list \
  [--resource-type <resource-type>] \
  [--impact <impact>] \
  [--category <category>]
Parameter Type Erforderlich Beschreibung
category Schnur No Optionaler Beraterkategoriefilter. Typische Werte: Cost, , HighAvailability, Security, Performance, OperationalExcellence ( Groß-/Kleinschreibung wird nicht beachtet). Neue Kategorien, die von Advisor in Zukunft unterstützt werden, stimmen weiterhin überein.
impact Schnur No Optionaler Filter für den Auswirkungsgrad. Zulässige Werte: High, Medium, Low (Groß-/Kleinschreibung wird nicht beachtet). Wenn sie weggelassen werden, enthalten die Ergebnisse alle Auswirkungsebenen, sind aber weiterhin hoch, mittel, niedrig sortiert.
resource-type Schnur No Optionaler Azure-Ressourcentyp, um die Ergebnisse einzugrenzen (zum Beispiel microsoft.compute/virtualmachines, microsoft.sql/servers). Ohne Berücksichtigung der Groß-/Kleinschreibung mit dem Feld supportedResourceType bei jedem Empfehlungstyp abgeglichen. Verwenden Sie diesen Parameter beim Onboarding eines neuen Ressourcentyps, um nur die Empfehlungen anzuzeigen, die der Ratgeber dafür generiert.

Hinweise für Anmerkungen im Tool:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich