Informatiebanners toevoegen en beheren in Azure Devops
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Een snelle en effectieve manier om te communiceren met uw Azure DevOps-gebruikers is via informatiebanners. Gebruik banners om gebruikers te waarschuwen voor toekomstige wijzigingen of gebeurtenissen zonder massa-e-mailberichten te verzenden.
U kunt een van de drie typen banners opgeven: fout, informatie en waarschuwing. Slechts één banner, de laatste die is toegevoegd of bijgewerkt, wordt tegelijk weergegeven. Banners blijven van kracht tot hun vervaldatum.
In de volgende afbeelding ziet u hoe een informatiebericht wordt weergegeven. Gebruikers kunnen het bericht annuleren door Sluiten te selecteren.
Banners zijn beperkt tot een lengte van dertig woorden. Banners krijgen prioriteit op niveau. Als u bijvoorbeeld een waarschuwingsbericht en een infobericht hebt gepost, wordt het informatiebericht alleen weergegeven nadat een gebruiker het waarschuwingsbericht heeft gesloten of u verwijdert het waarschuwingsbericht.
Vereisten
- Als u banners wilt toevoegen of beheren, moet u lid zijn van de beveiligingsgroep Projectverzamelingsbeheerders . Zie Machtigingen wijzigen op organisatie- of verzamelingsniveau om toe te voegen.
- Als u banners wilt beheren met de extensie Bannerinstellingen, moet u deze eerst installeren. Zie Bannerinstellingen en Extensies installeren
- Als u banners wilt beheren met behulp van de opdrachtregel, moet u de Azure DevOps CLI-extensie installeren, zoals beschreven in Aan de slag met Azure DevOps CLI.
- Meld u aan bij Azure DevOps met behulp van
az login
. - Stel voor de voorbeelden in dit artikel de standaardorganisatie in met behulp van
az devops configure --defaults organization=YourOrganizationURL
.
- Meld u aan bij Azure DevOps met behulp van
- Als u banners wilt toevoegen of beheren, moet u lid zijn van de beveiligingsgroep Projectverzamelingsbeheerders . Zie Machtigingen wijzigen op organisatie- of verzamelingsniveau om toe te voegen.
- U moet de gratis Banner Settings Marketplace-extensie installeren in de projectverzameling waar u banners wilt beheren. Zie ook Extensies installeren voor on-premises servers.
Banners beheren met de bannerinstellingenextensie
De extensie Bannerinstellingen biedt een instellingenvenster onder Organisatie-instellingen om sitebrede banners toe te voegen en te beheren. De extensie ondersteunt de volgende functies:
De extensie Bannerinstellingen biedt een instellingenvenster onder Verzamelingsinstellingen om siteomvattende banners toe te voegen en te beheren. De extensie ondersteunt de volgende functies:
- Banners weergeven op elke pagina in Azure DevOps
- Kiezen tussen drie niveaus van berichten: Info, Waarschuwing en Fout
- Een vervaldatum voor een bericht kiezen
- Hyperlinks opnemen in banners met behulp van markdown-syntaxis.
Organisatie-instellingen openen
Als u een banner wilt toevoegen of verwijderen, opent u Organisatie-instellingen, schuift u omlaag naar de sectie Extensies en kiest u Banner.
Organisatie-instellingen configureren resources voor respectievelijk alle projecten voor de hele organisatie. Zie de beheerdersrol projectverzameling en het beheren van verzamelingen van projecten voor een overzicht van alle organisatie-instellingen.
Kies het
Azure DevOps-logo om Projecten te openen en kies vervolgens Organisatie-instellingen.
Beheerdersinstellingen openen
Als u een banner wilt toevoegen of verwijderen, opent u Beheerdersinstellingen, schuift u omlaag naar de sectie Extensies en kiest u Banner.
Beheerdersinstellingen configureren resources voor alle projecten in een projectverzameling. Zie de rol beheerder van de projectverzameling en het beheren van verzamelingen van projecten voor een overzicht van alle verzamelingsinstellingen.
Kies het
Azure DevOps-logo om Verzamelingen te openen en kies vervolgens Beheerdersinstellingen.
Banners toevoegen en beheren
Als er geen banners zijn gedefinieerd, kiest u Een nieuwe banner maken.
Voer de bannertekst in het tekstvak in. Kies Meer bewerken om het berichtniveau te wijzigen en de vervaldatum in te stellen.
Kies
Opslaan om uw wijzigingen op te slaan.
Azure CLI-beheerbanneropdrachten
Opdracht | Beschrijving |
---|---|
az devops admin banner add |
Voeg een nieuwe banner toe en laat deze direct zien. |
az devops admin banner list |
Lijstbanners. |
az devops admin banner remove |
Een banner verwijderen. |
az devops admin banner show |
Details voor een banner weergeven. |
az devops admin banner update |
Werk het bericht, het niveau of de vervaldatum voor een banner bij. |
De volgende parameters zijn optioneel voor alle opdrachten en worden niet vermeld in de voorbeelden in dit artikel.
- detecteren: organisatie automatisch detecteren. Geaccepteerde waarden: onwaar, waar. De standaardwaarde is waar.
- organisatie: URL van Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met az devops configure -d organization=ORG_URL. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie. Voorbeeld:
--org https://dev.azure.com/MyOrganizationName/
.
Een banner toevoegen
Als u een banner wilt toevoegen, voert u de az devops admin banner add
opdracht in.
az devops admin banner add --message
[--expiration]
[--id]
[--type {error, info, warning}]
Parameters
bericht: Vereist. Tekenreeks die het bannerbericht aangeeft dat moet worden weergegeven. Tekenreeksen zijn beperkt tot maximaal dertig woorden.
Het bericht bevat mogelijk koppelingen in HTML-indeling (
<a href='https://example.org'>Link text</a>
). Alle ampersanden in de URL, bijvoorbeeld in de querytekenreeks, moeten worden ontsnapt in de XML-entiteitsindeling (&
).vervaldatum: optioneel. Datum/tijd waarop de banner niet meer voor gebruikers mag worden weergegeven. Bijvoorbeeld '2019-06-10 17:21:00 UTC', '2019-06-10'.
Id: optioneel. Id van de banner die moet worden bijgewerkt. Deze id is nodig om het bericht later te wijzigen of te verwijderen. Er wordt automatisch een unieke id gemaakt als er geen id is opgegeven.
type: Optioneel. Type banner dat moet worden weergegeven. Geldige waarden: fout, info, waarschuwing. De standaardwaarde is informatie.
Opmerking
Met de volgende opdracht wordt bijvoorbeeld een informatiebanner toegevoegd, die verloopt op 4 september 2019. Wanneer er geen id is opgegeven, wordt automatisch een unieke id toegewezen.
az devops admin banner add --message "INFORMATION: Network domain updates will occur on September 3. <a href='https://example.org?page=network-updates&anchor=september-3-2019'>More information</a>" --expiration 2019-09-04 --type info
{
"3d584103-6a94-4f46-8696-f424278da072": {
"expirationDate": "2019-09-04T00:00:00-07:00",
"level": "info",
"message": "INFORMATION: Network domain updates will occur on September 3"
}
}
Lijstbanners
Voer de az devops admin banner list
opdracht in om te bepalen welke banners zijn gedefinieerd.
az devops admin banner list
Voorbeeld: Standaard-json-uitvoer
Als u de uitvoer niet opgeeft, wordt de lijst weergegeven in json-indeling. Zie Uitvoerindelingen voor Azure CLI-opdrachten voor andere opties voor uitvoerindelingen.
Met de volgende opdracht wordt bijvoorbeeld aangegeven dat er twee banners zijn gedefinieerd.
az devops admin banner list
{
"04c4d27f-1fee-4f23-9c44-57ed6a9efef8": {
"level": "info",
"message": "BANNER-MESSAGE-BANNER-MESSAGE"
},
"27f016aa-be13-4e3b-a1da-8b98d239e074": {
"level": "warning",
"message": "WARNING - This is a test warning message."
}
}
Voorbeeld: Tabeluitvoer
Als u de banners in tabelindeling wilt weergeven, gebruikt u de --output table
opdrachtoptie.
az devops admin banner list
ID Message Type Expiration Date
------------------------------------ --------------------------------- ------- -----------------
04c4d27f-1fee-4f23-9c44-57ed6a9efef8 BANNER-MESSAGE-BANNER-MESSAGE Info
27f016aa-be13-4e3b-a1da-8b98d239e074 WARNING - This is a test warning message.
Een banner verwijderen
Als u een banner wilt verwijderen, gebruikt u de az devops admin banner remove
opdracht. Geef de banner-id op die u kunt vinden door de banners weer te geven.
az devops admin banner remove --id
Parameters
- Id: vereist. Id van de banner die u wilt verwijderen.
Opmerking
Met de volgende opdracht wordt bijvoorbeeld de banner verwijderd met id=e090e7b0-4499-4b8f-a09b-1eddf7fdeb44
. Er wordt geen antwoord geretourneerd.
az devops admin banner remove --id e090e7b0-4499-4b8f-a09b-1eddf7fdeb44
Details van de lijstbanner
Gebruik de az devops admin banner show
opdracht om informatie over één banner weer te geven. Geef de banner-id op die u kunt vinden door de banners weer te geven.
az devops admin banner show --id
Parameters
- Id: vereist. Id van de banner om details weer te geven.
Opmerking
Hier vermelden we de details voor banner met id=7653f414-3c01-424f-8f84-e51aa99b797c
.
az devops admin banner show --id 7653f414-3c01-424f-8f84-e51aa99b797c
{
"7653f414-3c01-424f-8f84-e51aa99b797c": {
"expirationDate": "2019-09-04T07:00:00+00:00",
"level": "info",
"message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce ac lectus eget erat porttitor dapibus vulputate in ipsum. Etiam id faucibus nisi, at ornare tellus. Curabitur faucibus pharetra orci, id finibus leo iaculis et. Morbi nec felis facilisis, ultricies magna nec, convallis sem. Sed pharetra porta mi eu venenatis. Cras consectetur et dui a accumsan. Maecenas non dolor eu lacus mollis pulvinar. Fusce gravida id lacus sed consequat. Cras tempus ante tincidunt purus rhoncus, at consectetur tellus sollicitudin. Proin sed tellus vel libero maximus ornare. Nullam facilisis, nibh sit amet faucibus rutrum, diam massa ullamcorper purus, sed tempor est erat in sapien. Sed sit amet lectus vel massa facilisis interdum id sit amet nisi. Vestibulum eu purus et mi ultricies consequat. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum fermentum mattis rutrum. Nulla hendrerit nibh ut sapien viverra faucibus."
}
}
Een banner bijwerken
U kunt het bericht, het type en de vervaldatum van een banner wijzigen met behulp van de az devops admin banner update
opdracht.
az devops admin banner update --id
[--expiration]
[--message]
[--type {error, info, warning}]
Parameters
- Id: vereist. Id van de banner die moet worden bijgewerkt.
- vervaldatum: optioneel. Datum/tijd waarop de banner niet meer voor gebruikers mag worden weergegeven. Als u de vervaldatum voor de banner wilt opheffen, geeft u een lege waarde op voor dit argument, bijvoorbeeld '2019-06-10 17:21:00 UTC', '2019-06-10'.
- bericht: Tekenreeks die het bannerbericht aangeeft dat moet worden weergegeven.
- type: Optioneel. Type banner dat moet worden weergegeven. Geldige waarden: fout, info, waarschuwing. De standaardwaarde is informatie.
Opmerking
Met de volgende opdracht wordt bijvoorbeeld de berichttekenreeks voor de banner bijgewerkt en wordt de vervaldatum bijgewerkt tot het einde van het jaar.
az devops admin banner update --id 7653f414-3c01-424f-8f84-e51aa99b797c --message "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce ac lectus eget erat porttitor dapibus vulputate in ipsum. Etiam id faucibus nisi, at ornare tellus. Curabitur faucibus pharetra orci, id finibus leo iaculis et. Morbi nec felis facilisis, ultricies magna nec, convallis sem. Sed pharetra porta mi eu venenatis. Cras consectetur et dui a accumsan. Maecenas non dolor eu lacus mollis pulvinar. Fusce gravida id lacus sed consequat. Cras tempus ante tincidunt purus rhoncus, at consectetur tellus sollicitudin. Proin sed tellus vel libero maximus ornare. Nullam facilisis, nibh sit amet faucibus rutrum, diam massa ullamcorper purus, sed tempor est erat in sapien. Sed sit amet lectus vel massa facilisis interdum id sit amet nisi. Vestibulum eu purus et mi ultricies consequat. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum fermentum mattis rutrum. Nulla hendrerit nibh ut sapien viverra faucibus. " --expiration 2019-12-31
{
"7653f414-3c01-424f-8f84-e51aa99b797c": {
"expirationDate": "2019-12-31T00:00:00-08:00",
"level": "info",
"message": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce ac lectus eget erat porttitor dapibus vulputate in ipsum. Etiam id faucibus nisi, at ornare tellus. Curabitur faucibus pharetra orci, id finibus leo iaculis et. Morbi nec felis facilisis, ultricies magna nec, convallis sem. Sed pharetra porta mi eu venenatis. Cras consectetur et dui a accumsan. Maecenas non dolor eu lacus mollis pulvinar. Fusce gravida id lacus sed consequat. Cras tempus ante tincidunt purus rhoncus, at consectetur tellus sollicitudin. Proin sed tellus vel libero maximus ornare. Nullam facilisis, nibh sit amet faucibus rutrum, diam massa ullamcorper purus, sed tempor est erat in sapien. Sed sit amet lectus vel massa facilisis interdum id sit amet nisi. Vestibulum eu purus et mi ultricies consequat. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum fermentum mattis rutrum. Nulla hendrerit nibh ut sapien viverra faucibus. "
}
}