Delen via

az repos policy build

Note

Deze verwijzing maakt deel uit van de azure-devops-extensie voor de Azure CLI (versie 2.30.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az repos policy build opdracht uitvoert. Meer informatie over uitbreidingen.

Buildbeleid beheren.

Opdracht

Name Description Type Status
az repos policy build create

Maak buildbeleid.

 Extension GA
az repos policy build update

Buildbeleid bijwerken.

 Extension GA

az repos policy build create

Maak buildbeleid.

az repos policy build create --blocking {false, true}
                             --branch
                             --build-definition-id
                             --display-name
                             --enabled {false, true}
                             --manual-queue-only {false, true}
                             --queue-on-source-update-only {false, true}
                             --repository-id
                             --valid-duration
                             [--branch-match-type {exact, prefix}]
                             [--detect {false, true}]
                             [--org --organization]
                             [--path-filter]
                             [--project]

Vereiste parameters

--blocking

Of het beleid moet worden geblokkeerd of niet.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--branch

Vertakking waarop dit beleid moet worden toegepast. Bijvoorbeeld: master.

--build-definition-id

Definitie-id bouwen.

--display-name

Weergavenaam voor dit buildbeleid om het beleid te identificeren. Bijvoorbeeld: 'Handmatig wachtrijbeleid'.

--enabled

Of het beleid al dan niet is ingeschakeld.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--manual-queue-only

Of u alleen handmatige wachtrij met builds wilt toestaan.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--queue-on-source-update-only

Wachtrij alleen bij bronupdate.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--repository-id

Id van de opslagplaats waarop het beleid moet worden toegepast.

--valid-duration

Geldigheidsduur van beleid (in minuten).

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--branch-match-type

Bepaalt hoe het vertakkingsargument wordt gebruikt om een beleid toe te passen. Als de waarde 'exact' is, wordt het beleid toegepast op een vertakking die een exacte overeenkomst heeft met het argument --branch. Als de waarde 'voorvoegsel' is, wordt het beleid toegepast op alle vertakkingsmappen die overeenkomen met het voorvoegsel dat wordt geleverd door het argument --branch.

Eigenschap Waarde
Default value: exact
Geaccepteerde waarden: exact, prefix
--detect

Organisatie automatisch detecteren.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--org --organization

Url van de 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: https://dev.azure.com/MyOrganizationName/.

--path-filter

Filterpad(en) waarop het beleid wordt toegepast. Ondersteunt absolute paden, jokertekens en meerdere paden, gescheiden door ';'. Voorbeeld: /WebApp/Models/Data.cs, /WebApp/* of *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Naam of id van het project. U kunt het standaardproject configureren met az devops configure -d project=NAME_OR_ID. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az repos policy build update

Buildbeleid bijwerken.

az repos policy build update --id --policy-id
                             [--blocking {false, true}]
                             [--branch]
                             [--branch-match-type {exact, prefix}]
                             [--build-definition-id]
                             [--detect {false, true}]
                             [--display-name]
                             [--enabled {false, true}]
                             [--manual-queue-only {false, true}]
                             [--org --organization]
                             [--path-filter]
                             [--project]
                             [--queue-on-source-update-only {false, true}]
                             [--repository-id]
                             [--valid-duration]

Vereiste parameters

--id --policy-id

Id van het beleid.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--blocking

Of het beleid moet worden geblokkeerd of niet.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--branch

Vertakking waarop dit beleid moet worden toegepast. Bijvoorbeeld: master.

--branch-match-type

Bepaalt hoe het vertakkingsargument wordt gebruikt om een beleid toe te passen. Als de waarde 'exact' is, wordt het beleid toegepast op een vertakking die een exacte overeenkomst heeft met het argument --branch. Als de waarde 'voorvoegsel' is, wordt het beleid toegepast op alle vertakkingsmappen die overeenkomen met het voorvoegsel dat wordt geleverd door het argument --branch.

Eigenschap Waarde
Geaccepteerde waarden: exact, prefix
--build-definition-id

Definitie-id bouwen.

--detect

Organisatie automatisch detecteren.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--display-name

Weergavenaam voor dit buildbeleid om het beleid te identificeren. Bijvoorbeeld: 'Handmatig wachtrijbeleid'.

--enabled

Of het beleid al dan niet is ingeschakeld.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--manual-queue-only

Of u alleen handmatige wachtrij met builds wilt toestaan.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--org --organization

Url van de 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: https://dev.azure.com/MyOrganizationName/.

--path-filter

Filterpad(en) waarop het beleid wordt toegepast. Ondersteunt absolute paden, jokertekens en meerdere paden, gescheiden door ';'. Voorbeeld: /WebApp/Models/Data.cs, /WebApp/* of *.cs,/WebApp/Models/Data.cs; ClientApp/Models/Data.cs.

--project -p

Naam of id van het project. U kunt het standaardproject configureren met az devops configure -d project=NAME_OR_ID. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie.

--queue-on-source-update-only

Wachtrij alleen bij bronupdate.

Eigenschap Waarde
Geaccepteerde waarden: false, true
--repository-id

Id van de opslagplaats waarop het beleid moet worden toegepast.

--valid-duration

Geldigheidsduur van beleid (in minuten).

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False