Dela via


Aktivera banderollen för tilläggsupptäckt

Funktionen för tilläggsupptäcktsbanner introducerades i Windows Admin Center Preview 1903. Med den här funktionen kan ett tillägg deklarera servermaskinvarans tillverkare och modeller som det stöder, och när en användare ansluter till en server eller ett kluster som ett tillägg är tillgängligt för visas en meddelandebanderoll för att enkelt installera tillägget. Tilläggsutvecklare kommer att kunna få mer synlighet för sina tillägg och användarna kommer enkelt att kunna identifiera fler hanteringsfunktioner för sina servrar.

tilläggsidentifieringsbanderoll

Så här fungerar banderollen för upptäckt av tillägg

När Windows Admin Center startas ansluter det till de registrerade tilläggsfeedarna och hämtar metadata för de tillgängliga tilläggspaketen. När en användare sedan ansluter till en server eller ett kluster i Administrationscenter för Windows läser vi tillverkaren och modellen för servermaskinvara som ska visas i översiktsverktyget. Om vi hittar ett tillägg som deklarerar att det stöder den aktuella serverns tillverkare och/eller modell visar vi en banderoll som meddelar användaren. Om du klickar på länken "Konfigurera nu" kommer användaren till Tilläggshanteraren där de kan installera tillägget.

Så här implementerar du banner för tilläggsupptäckt.

Metadata för "taggar" i .nuspec-filen används för att deklarera vilka maskinvarutillverkare och/eller modeller som tillägget stöder. Taggar avgränsas av blanksteg och du kan lägga till antingen en tillverkare eller modelltagg, eller båda för att deklarera den tillverkare och/eller modeller som stöds. Taggformatet är "[value type]_[value condition]" där [värdetyp] antingen är "Tillverkare" eller "Modell" (skiftlägeskänsligt) och [värdevillkor] är ett javascript-reguljärt uttryck definiera tillverkaren eller modellsträngen, och [värdetyp] och [värdevillkor] avgränsas med ett understreck. Den här strängen kodas sedan med hjälp av URI-kodning och läggs till i metadatasträngen .nuspec "taggar".

Exempel

Låt oss säga att jag har utvecklat ett tillägg som stöder servrar från ett företag med namnet Contoso Inc., med modellnamnet R3xx och R4xx.

  1. Taggen för tillverkaren skulle vara "Manufacturer_/Contoso Inc./". Taggen för modellerna kan vara "Model_/^R[34][0-9]{2}$/". Beroende på hur strikt du vill definiera matchande villkor finns det olika sätt att definiera ditt reguljära uttryck. Du kan också separera taggarna Tillverkare eller Modell i flera taggar, till exempel kan modelltaggen också vara "Model_/R3../ Model_/R4../".

  2. Du kan testa det reguljära uttrycket med webbläsarens DevTools-konsol. I Edge eller Chrome trycker du på F12 för att öppna DevTools-fönstret, och på fliken Konsol skriver du följande och trycker på Retur:

    var regex = /^R[34][0-9]{2}$/
    

    Om du sedan skriver och kör följande returneras "true".

    regex.test('R300')
    

    Och om du kör följande, kommer det att returnera 'false'.

    regex.test('R500')
    
  3. När du har verifierat det reguljära uttrycket kan du också koda det i DevTools-konsolen med hjälp av följande Javascript-metod:

    encodeURI(/^R[34][0-9]{2}$/)
    

    Det slutliga formatet för taggsträngen som ska läggas till i .nuspec-filen är:

    <tags>Manufacturer_/Contoso%20Inc./ Model_/%5ER%5B34%5D%5B0-9%5D%7B2%7D$/</tags>
    

Tips

Vi förstår att en maskinvarutillverkare kan ha ett mycket brett utbud av modellnamn som vissa kan ha stöd för även om vissa inte är det. Tänk på att den här funktionen är avsedd att hjälpa till med identifiering av ditt tillägg, men det behöver inte vara en perfekt up-todatuminventering av alla dina modeller. Du kan definiera ditt reguljära uttryck som ett enklare uttryck som matchar en delmängd av dina modeller. En användare kanske inte ser identifieringsbanderollen om de först ansluter till en servermodell som inte matchar villkoret, men förr eller senare ansluter de till en annan server som identifierar och installerar tillägget. Du kan också överväga att definiera ett enkelt reguljärt uttryck som endast matchar tillverkarens namn. I vissa fall kanske tillägget inte har stöd för en specifik modell, men du kan använda funktionen för dynamiskt verktygsvisning för att definiera ett anpassat PowerShell-skript för att kontrollera modellstöd och endast visa ditt tillägg när det är tillämpligt, eller tillhandahålla begränsade funktioner i tillägget för modeller som inte stöder alla funktioner.