Condividi tramite

az devops admin banner

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione azure-devops per l'interfaccia della riga di comando di Azure (versione 2.30.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az devops admin banner. Altre informazioni sulle estensioni.

Gestire il banner dell'organizzazione.

Comandi

Nome Descrizione Tipo Status
az devops admin banner add

Aggiungere un nuovo banner e visualizzarlo immediatamente.

 Estensione GA
az devops admin banner list

Elencare i banner.

 Estensione GA
az devops admin banner remove

Rimuovere un banner.

 Estensione GA
az devops admin banner show

Mostra i dettagli di un banner.

 Estensione GA
az devops admin banner update

Aggiornare il messaggio, il livello o la data di scadenza per un banner.

 Estensione GA

az devops admin banner add

Aggiungere un nuovo banner e visualizzarlo immediatamente.

az devops admin banner add --message
                           [--detect {false, true}]
                           [--expiration]
                           [--id]
                           [--org]
                           [--type {error, info, warning}]

Parametri necessari

--message -m

Messaggio (stringa) da visualizzare nel banner.

Parametri facoltativi

--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--expiration

Data/ora in cui il banner non deve più essere presentato agli utenti. Se non è impostato, il banner non scade automaticamente e deve essere rimosso con il comando remove. Esempio: "2019-06-10 17:21:00 UTC", "2019-06-10".

--id

Identificatore del nuovo banner. Questo identificatore è necessario per modificare o rimuovere il messaggio in un secondo momento. Se non ne viene specificato uno, viene creato automaticamente un identificatore univoco.

--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--type -t

Tipo di banner da presentare. Le impostazioni predefinite sono "info".

Valori accettati: error, info, warning
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az devops admin banner list

Elencare i banner.

az devops admin banner list [--detect {false, true}]
                            [--org]

Parametri facoltativi

--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az devops admin banner remove

Rimuovere un banner.

az devops admin banner remove --id
                              [--detect {false, true}]
                              [--org]

Parametri necessari

--id

ID del banner da rimuovere.

Parametri facoltativi

--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az devops admin banner show

Mostra i dettagli di un banner.

az devops admin banner show --id
                            [--detect {false, true}]
                            [--org]

Parametri necessari

--id

Identificatore del banner.

Parametri facoltativi

--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az devops admin banner update

Aggiornare il messaggio, il livello o la data di scadenza per un banner.

az devops admin banner update --id
                              [--detect {false, true}]
                              [--expiration]
                              [--message]
                              [--org]
                              [--type {error, info, warning}]

Parametri necessari

--id

ID del banner da aggiornare.

Parametri facoltativi

--detect

Riconoscere automaticamente l'organizzazione.

Valori accettati: false, true
--expiration

Data/ora in cui il banner non deve più essere presentato agli utenti. Per annullare l'impostazione della scadenza per il banner, fornire un valore vuoto a questo argomento. Esempio: "2019-06-10 17:21:00 UTC", "2019-06-10".

--message -m

Messaggio (stringa) da visualizzare nel banner.

--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--type -t

Tipo di banner da presentare. Le impostazioni predefinite sono "info".

Valori accettati: error, info, warning
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato dell'output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.