Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
De Azure MCP-server helpt u bij het beheren van Azure Advisor resources, waaronder het toepassen van aanbevelingen, het ophalen van details, het weergeven van aanbevelingen en het verstrekken van samenvattingen, allemaal via prompts in natuurlijke taal.
Azure Advisor analyseert uw Azure resources en levert persoonlijke, bruikbare aanbevelingen om kosten, prestaties, betrouwbaarheid en beveiliging te optimaliseren. Zie Azure Advisor documentatie voor meer informatie.
Opmerking
Hulpprogrammaparameters: de Hulpprogramma's van Azure MCP Server definiëren parameters voor gegevens die ze nodig hebben om taken uit te voeren. Sommige van deze parameters zijn specifiek voor elk hulpprogramma en worden hier beschreven. Andere parameters zijn globaal en worden gedeeld door alle hulpprogramma's. Zie Hulpprogrammaparameters voor meer informatie.
Metagegevens: Ophalen
Hiermee haalt u Azure Advisor metagegevens op voor een specifiek aanbevelingstype. Retourneert de weergavenaam, categorie, subcategorie, impact, ondersteunde resourcetypen, beschrijving, mogelijke voordelen en herstelacties van het aanbevelingstype. Gebruik de metagegevens om inzicht te krijgen in de aanbeveling, de impact ervan te beoordelen en herstelstappen te plannen.
Voorbeeld van CLI-opdracht
azmcp advisor metadata get \
--recommendation-type-id <recommendation-type-id> \
[--language <language>]
| Parameter | Type | Required | Beschrijving |
|---|---|---|---|
recommendation-type-id |
tekenreeks | Yes | De ID van het stabiele aanbevelingstype van Advisor (properties.recommendationTypeId) om in de algemene catalogus met metagegevens van aanbevelingen op te zoeken. Deze ID is de koppelingssleutel die gemeenschappelijk is voor individuele aanbevelingen. |
language |
tekenreeks | No | Cataloguslocale om op te filteren (properties.language). Wordt standaard ingesteld op en. Niet hoofdlettergevoelig. Ondersteunde waarden: en, cs, de, es, fr, hu, it, id, ja, pl, pt-pt, sv, ru, tr, nl, pt-br, ko, zh-hans, zh-hant. Advisor accepteert regio-gekwalificeerde tags, zoals en-US en wijst deze toe aan de basistaal (en). |
Hints voor aantekening van hulpprogramma's:
| Destructief | Idempotent (onveranderlijk bij herhaald gebruik) | Open wereld | Alleen lezen | Secret | Lokaal vereist |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Metagegevens: Lijst
Geeft een lijst van de metagegevens van Azure Advisor-aanbevelingen, ook wel aanbevelingstypen genoemd. Hiermee kunt u ontdekken welke aanbevelingen Azure Advisor kunnen produceren voordat u resources zoals virtuele machines implementeert, zelfs wanneer er geen actieve aanbevelingen bestaan. Toont uitdienststellingen van Advisor-services die plaatsvinden op, vóór of na een opgegeven uitdienststellingsdatum, en zoekt metagegevens over service-uitdienststellingen op basis van de tracking-id van Service Health. Ondersteunt greenfield-detectie met de globale Azure Resource Graph-catalogus en filters op resourcetypen voor brownfield-onboarding. Accepteert optionele filters voor taal, resourcetype, impact, categorie, subcategorie, tracerings-id en buitengebruikstellingsdatum. Geeft gelokaliseerde type-ID's, namen, categorieën, subcategorieën, impact, prioriteit, beschrijvingen, voordelen, acties, toepassingsgebied, bronquery en details over de uitfasering van diensten terug. Sorteert resultaten op impact van Hoog naar Gemiddeld naar Laag, en vervolgens op weergavenaam.
Voorbeeld van CLI-opdracht
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 | Type | Required | Beschrijving |
|---|---|---|---|
language |
tekenreeks | No | Taal voor gelokaliseerde metagegevens van aanbevelingen. Standaard ingesteld op Engels (en). Ondersteunde catalogustalen zijn en, cs, de, es, hu, fr, id, it, nl, pl, ja, sv, ru, tr, pt-BR, pt-PT, ko, zh-Hans en zh-Hant. Regionale varianten worden gekoppeld aan een ondersteunde basistaal wanneer die beschikbaar is, zoals van en-US naar en en van fr-CA naar fr; lokale catalogustalen blijven onderscheiden. |
resource-type |
tekenreeks | No | Optioneel filter voor exact Azure-resourcetype, zoals microsoft.compute/virtualmachines. Gebruik dit tijdens brownfield-onboarding om typen aanbevelingen te ontdekken die van toepassing zijn op dat resourcetype. Het filter is niet hoofdlettergevoelig. |
impact |
tekenreeks | No | Optioneel filter voor de impact van aanbevelingen. Toegestane waarden zijn High, Mediumof Low. Het filter is niet hoofdlettergevoelig. Standaard worden de resultaten weergegeven in High, Mediumen vervolgens Low in volgorde. |
category |
tekenreeks | No | Optionele exacte categoriefilter voor adviseurs. Toegestane waarden zijnCost, , , HighAvailabilityen SecurityPerformanceOperationalExcellence. Het filter is niet hoofdlettergevoelig. |
sub-category |
tekenreeks | No | Optioneel subcategoriefilter voor exacte aanbevelingen. Het filter is niet hoofdlettergevoelig. Bekende cataloguswaarden omvatten ComputeOptimization, DataProtectionAndRecovery, EfficiencyOptimization, FailureMitigation, GovernanceAndCompliance, MonitoringAndAlerting, NetworkOptimization, Other, SafeAndSecureDeployment, Reservations, ServiceUpgradeAndRetirement, SavingsPlan, Personalized, Scalability, RegionalResiliency, StorageOptimization, UsageOptimization, ZoneResiliency en DataPerformance. De catalogus kan in de loop van de tijd waarden toevoegen, zodat het hulpprogramma andere subcategorieën accepteert. |
tracking-id |
tekenreeks | No | Optioneel filter voor de exacte tracking-id van Service Health, zoals QNY1-HB8. Het filter is niet hoofdlettergevoelig en is van toepassing binnen ServiceUpgradeAndRetirement metagegevens. U kunt weglaten --sub-category, maar u kunt geen andere waarde opgeven. |
retirement-date |
tekenreeks | No | Optioneel filter voor de uitdienststellingsdatum in de notatie <operator>:<yyyy-MM-dd>, bijvoorbeeld ge:2026-03-31. Ondersteunde operators zijneq, lt, , leen gtge. Is alleen van toepassing op de ServiceUpgradeAndRetirement subcategorie. U kunt weglaten --sub-category, maar u kunt geen andere waarde opgeven. |
Hints voor aantekening van hulpprogramma's:
| Destructief | Idempotent (onveranderlijk bij herhaald gebruik) | Open wereld | Alleen lezen | Secret | Lokaal vereist |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Aanbeveling: Toepassen
Hiermee kunt u Azure Advisor aanbevelingen toepassen op IaC-bestanden (infrastructure-as-code), zoals arm-sjablonen (Azure Resource Manager) en Terraform-configuraties. Het geeft regels terug die op het IaC-bestand moeten worden toegepast.
Voorbeeld van CLI-opdracht
azmcp advisor recommendation apply \
--resource <resource>
| Parameter | Type | Required | Beschrijving |
|---|---|---|---|
resource |
tekenreeks | Yes | Het Azure-resourcetype waarvoor IaC-bestandsregels worden opgehaald. Beschikbare opties: 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 |
Hints voor aantekening van hulpprogramma's:
| Destructief | Idempotent (onveranderlijk bij herhaald gebruik) | Open wereld | Alleen lezen | Secret | Lokaal vereist |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Aanbeveling: Lijst
Bevat afzonderlijke Azure Advisor aanbevelingen voor een abonnement en retourneert één record per aanbeveling. Gebruik deze opdracht alleen om de inhoud en details van de aanbeveling weer te geven. Gebruik in plaats daarvan voor vragen advisor recommendation summary over aggregaat, rangschikken, vergelijken of tellen. Retourneert alleen actieve aanbevelingen met status New en sluit genegeerde en uitgesteld aanbevelingen uit. Ondersteunt optionele filters voor categorie, impact, resourcetype, resource en zoeken in vrije tekst. Een top parameterlimiet retourneert items met een standaardwaarde van 50 en maximaal 100. Omdat de opdracht maximaal 100 records retourneert, kan het gebruik van de resultaten ervan voor geaggregeerde berekeningen leiden tot een onderschatting van het totaal.
Voorbeeld van CLI-opdracht
azmcp advisor recommendation list \
[--category <category>] \
[--impact <impact>] \
[--resource-type <resource-type>] \
[--resource <resource>] \
[--search <search>] \
[--top <top>] \
[--resource-group <resource-group>]
| Parameter | Type | Required | Beschrijving |
|---|---|---|---|
category |
tekenreeks | No | Filter aanbevelingen op categorie (bijvoorbeeldSecurity, Cost, Performance, , HighAvailability, ). OperationalExcellence Hoofdlettergevoelige exacte overeenkomst. |
impact |
tekenreeks | No | Aanbevelingen filteren op bedrijfsimpact (High, Medium of Low). Hoofdlettergevoelige exacte overeenkomst. |
resource-type |
tekenreeks | No | Filter aanbevelingen op basis van het beïnvloede Azure-resource type (bijvoorbeeld Microsoft.Storage/storageAccounts). Hoofdlettergevoelige exacte overeenkomst. |
resource |
tekenreeks | No | Filter aanbevelingen op betrokken resourcenaam of volledige ARM-resource-id. Niet-hoofdlettergevoelige subtekenreeksovereenkomst. |
search |
tekenreeks | No | Past een vrijetekstfilter toe op de tekst van het aanbevelingsprobleem (overeenkomst met een subtekenreeks zonder onderscheid tussen hoofdletters en kleine letters). Gebruik dit wanneer een aanvraag een actuele woordgroep bevat, zoals related to Microsoft Foundry, about encryption, mentioning right-sizeof for Key Vault. Extraheer de belangrijkste zelfstandige naamwoorden uit de zinsnede (bijvoorbeeld Foundry, encrypt, right-size, Key Vault) en geef deze hier door. |
top |
tekenreeks | No | Maximum aantal te retourneren items. Voor list: is standaard ingesteld op 50 met een bereik aan de serverzijde van 1-100. Voor summary: optionele weergavelimiet voor het aantal buckets dat wordt geretourneerd (standaard ingesteld op alle).
TotalRecommendations weerspiegelt altijd de volledige gefilterde populatie, ongeacht --top. |
resource-group |
tekenreeks | No | De naam van de Azure-resourcegroep. |
Hints voor aantekening van hulpprogramma's:
| Destructief | Idempotent (onveranderlijk bij herhaald gebruik) | Open wereld | Alleen lezen | Secret | Lokaal vereist |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
Aanbeveling: Samenvatting
Met deze opdracht worden actieve Azure Advisor aanbevelingen met status New samengevoegd en worden aantallen per bucket geretourneerd plus een nauwkeurig totaal. Gebruik deze opdracht voor vragen over aggregaat, rangschikken, vergelijken en tellen. Filters zijn van toepassing vóór aggregatie. Groepeer resultaten op recommendation-type, category, impactof resource-type. De standaardgroepering is category, waarmee thema's op hoog niveau worden weergegeven, zoals Kosten, Beveiliging en Betrouwbaarheid. De top parameter beperkt de weergegeven buckets, maar TotalRecommendations weerspiegelt altijd de volledige gefilterde populatie. Met de opdracht blijft de Unknown bucket behouden als het uiteindelijke resultaat. Neem deze op als de laatste rij wanneer u groepen in een tabel weergeeft.
Voorbeeld van CLI-opdracht
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 | Type | Required | Beschrijving |
|---|---|---|---|
group-by |
tekenreeks | No | Veld om de samenvatting op te groeperen. Een van: recommendation-type, category, impact, . resource-type Standaard ingesteld op category, waarmee de hoofdthema’s (Kosten, Beveiliging, Betrouwbaarheid en meer) zichtbaar worden gemaakt, zodat prompts zoals summarize the key themes from my Advisor recommendations werken zonder een veld te benoemen. |
category |
tekenreeks | No | Filter aanbevelingen op categorie (bijvoorbeeldSecurity, Cost, Performance, , HighAvailability, ). OperationalExcellence Hoofdlettergevoelige exacte overeenkomst. |
impact |
tekenreeks | No | Aanbevelingen filteren op bedrijfsimpact (High, Medium of Low). Hoofdlettergevoelige exacte overeenkomst. |
resource-type |
tekenreeks | No | Filter aanbevelingen op basis van het beïnvloede Azure-resource type (bijvoorbeeld Microsoft.Storage/storageAccounts). Hoofdlettergevoelige exacte overeenkomst. |
resource |
tekenreeks | No | Filter aanbevelingen op betrokken resourcenaam of volledige ARM-resource-id. Niet-hoofdlettergevoelige subtekenreeksovereenkomst. |
search |
tekenreeks | No | Filter voor vrije tekst toegepast op de tekst van het aanbevelingsprobleem (overeenkomst met een deeltekenreeks zonder onderscheid tussen hoofdletters en kleine letters). Gebruik dit filter wanneer uw aanvraag een actuele woordgroep bevat, zoals related to Microsoft Foundry, about encryptionof mentioning right-sizefor Key Vault. Extraheer de belangrijkste zelfstandige naamwoorden uit de zinsnede (bijvoorbeeld Foundry, encrypt, right-size, Key Vault) en geef deze hier door. |
top |
tekenreeks | No | Maximum aantal te retourneren items. Voor list: is standaard ingesteld op 50, vastgeklemd tot 1-100 (limiet aan serverzijde). Voor summary: optionele weergavelimiet voor het aantal buckets dat wordt geretourneerd (standaard ingesteld op alle).
TotalRecommendations weerspiegelt altijd de volledige gefilterde populatie, ongeacht --top. |
resource-group |
tekenreeks | No | De naam van de Azure-resourcegroep. |
Hints voor aantekening van hulpprogramma's:
| Destructief | Idempotent (onveranderlijk bij herhaald gebruik) | Open wereld | Alleen lezen | Secret | Lokaal vereist |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |