az changesafety changerecord

Note

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

Manage ChangeRecord resources that describe planned changes across targets.

Opdracht

Name Description Type Status
az changesafety changerecord create

Maak een ChangeRecord-resource.

 Extension GA
az changesafety changerecord delete

Een ChangeRecord-resource verwijderen.

 Extension GA
az changesafety changerecord list

Resources voor ChangeRecord weergeven.

 Extension GA
az changesafety changerecord show

Details weergeven voor een ChangeRecord-resource.

 Extension GA
az changesafety changerecord update

Een bestaande ChangeRecord-resource bijwerken.

 Extension GA

az changesafety changerecord create

Maak een ChangeRecord-resource.

Geef ten minste één doeldefinitie op om te beschrijven welke resources of bewerkingen de ChangeRecord beïnvloeden. Doelen worden uitgedrukt als door komma's of door puntkomma's gescheiden sleutelparen, zoals resourceId=RESOURCE_ID,operation=DELETE. De opdracht is ook beschikbaar via de alias az changesafety changerecord. Als u planningsvlagmen weglaat, wordt de verwachte begintijd standaard ingesteld op nu en wordt de verwachte eindtijd standaard ingesteld op acht uur later (UTC).

az changesafety changerecord create --change-record-name --name
                                    [--acquire-policy-token]
                                    [--additional-data]
                                    [--anticipated-end-time]
                                    [--anticipated-start-time]
                                    [--change-definition]
                                    [--change-reference]
                                    [--change-type {AppDeployment, Config, ManualTouch, PolicyDeployment}]
                                    [--comments]
                                    [--description]
                                    [--links]
                                    [--orchestration-tool]
                                    [--parameters]
                                    [--release-label]
                                    [--resource-group]
                                    [--rollout-type {Emergency, Hotfix, Normal}]
                                    [--stage-map]
                                    [--stage-map-name --stagemap-name]
                                    [--targets]

Voorbeelden

Een ChangeRecord maken voor het verwijderen van een Traffic Manager-profiel

az changesafety changerecord create -g MyResourceGroup -n delete-trafficmanager --change-type ManualTouch --rollout-type Hotfix --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Network/trafficManagerProfiles/myProfile,operation=DELETE" --description "Delete Traffic Manager profile"

Verwijzen naar een StageMap op naam

az changesafety changerecord create -g MyResourceGroup -n changerecord003 --change-type ManualTouch --rollout-type Normal --stagemap-name rolloutStageMap --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=DELETE"

Maken met stageMap-verwijzing en statuskoppeling

az changesafety changerecord create -g MyResourceGroup -n changerecord002 --change-type ManualTouch --rollout-type Normal --stage-map "{resource-id:/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ChangeSafety/stageMaps/rolloutStageMap}" --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=PATCH" --links "[{name:status,uri:'https://contoso.com/change/rollout-002'}]"
az changesafety changerecord delete -g MyResourceGroup -n changerecord002 --yes

Maken op abonnementsbereik (geen resourcegroep)

az changesafety changerecord create -n changerecord-sub-scope --change-type AppDeployment --rollout-type Normal --stagemap-name rolloutStageMap --targets "subscriptionId=00000000-0000-0000-0000-000000000000"

Vereiste parameters

--change-record-name --name -n

De naam van de Resource ChangeRecord.

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.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--additional-data

Aanvullende metagegevens voor de wijziging die vereist is voor verschillende indelingshulpprogramma's. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap Waarde
Parametergroep: Properties Arguments
--anticipated-end-time

Verwachte voltooiingstijd in ISO 8601-indeling. De standaardwaarde is acht uur na de verwachte begintijd wanneer deze wordt weggelaten.

Eigenschap Waarde
Parametergroep: Properties Arguments
--anticipated-start-time

Verwachte begintijd in ISO 8601-indeling. Standaard ingesteld op de huidige UTC-tijd wanneer u dit weglaat.

Eigenschap Waarde
Parametergroep: Properties Arguments
--change-definition

Wijzigingstekst en/of selectiecriteria voor resources die worden gebruikt om de doelresources te identificeren. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap Waarde
Parametergroep: Properties Arguments
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--change-type

Classificeer de wijziging, zoals AppDeployment, Config, ManualTouch of PolicyDeployment.

Eigenschap Waarde
Parametergroep: Properties Arguments
Geaccepteerde waarden: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Opmerkingen over de laatste update van de ChangeRecord-resource.

Eigenschap Waarde
Parametergroep: Properties Arguments
--description

Een beschrijving van de wijziging die wordt uitgevoerd.

Eigenschap Waarde
Parametergroep: Properties Arguments
--links

Voeg ondersteunende koppelingen toe door --links name=NAME URI=URL [description=TEXT] te herhalen.

Eigenschap Waarde
Parametergroep: Properties Arguments
--orchestration-tool

Hulpprogramma dat wordt gebruikt voor de implementatie van deze wijziging.

Eigenschap Waarde
Parametergroep: Properties Arguments
--parameters

Schema van parameters die worden opgegeven voor elke stageProgression. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap Waarde
Parametergroep: Properties Arguments
--release-label

Label voor de release die aan deze wijziging is gekoppeld.

Eigenschap Waarde
Parametergroep: Properties Arguments
--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--rollout-type

Geef het implementatietype (Normaal, Hotfix of Noodgeval) op.

Eigenschap Waarde
Parametergroep: Properties Arguments
Geaccepteerde waarden: Emergency, Hotfix, Normal
--stage-map

Verwijs naar een bestaande StageMap-resource met behulp van resource-id=RESOURCE_ID en optionele parameterssleutel=waardeparen.

Eigenschap Waarde
Parametergroep: Properties Arguments
--stage-map-name --stagemap-name

StageMap-naam in het huidige abonnementsbereik; de resource-id is voor u gebouwd.

Eigenschap Waarde
Parametergroep: Properties Arguments
--targets

Een of meer doeldefinities uitgedrukt als sleutel-waardeparen (bijvoorbeeld resourceId=RESOURCE_ID,operation=DELETE,resourceType=Microsoft.Compute/virtualMachines).

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 changesafety changerecord delete

Een ChangeRecord-resource verwijderen.

az changesafety changerecord delete [--acquire-policy-token]
                                    [--change-record-name --name]
                                    [--change-reference]
                                    [--ids]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

Voorbeelden

Een ChangeRecord verwijderen zonder bevestiging

az changesafety changerecord delete -g MyResourceGroup -n changerecord001 --yes

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.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--change-record-name --name -n

De naam van de Resource ChangeRecord.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--subscription

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

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--yes -y

Niet vragen om bevestiging.

Eigenschap Waarde
Default value: False
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.

--verbose

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

Eigenschap Waarde
Default value: False

az changesafety changerecord list

Resources voor ChangeRecord weergeven.

Vermeld alle ChangeRecord-resources in een abonnement of resourcegroep.

az changesafety changerecord list [--max-items]
                                  [--next-token]
                                  [--resource-group]

Voorbeelden

Alle ChangeRecords in het huidige abonnement weergeven

az changesafety changerecord list

ChangeRecords in een specifieke resourcegroep weergeven

az changesafety changerecord list -g MyResourceGroup

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.

--max-items

Totaal aantal items dat moet worden geretourneerd in de uitvoer van de opdracht. Als het totale aantal beschikbare items groter is dan de opgegeven waarde, wordt een token opgegeven in de uitvoer van de opdracht. Als u paginering wilt hervatten, geeft u de tokenwaarde op in --next-token argument van een volgende opdracht.

Eigenschap Waarde
Parametergroep: Pagination Arguments
--next-token

Token om op te geven waar paginering moet worden gestart. Dit is de tokenwaarde van een eerder afgekapt antwoord.

Eigenschap Waarde
Parametergroep: Pagination Arguments
--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

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 changesafety changerecord show

Details weergeven voor een ChangeRecord-resource.

az changesafety changerecord show [--change-record-name --name]
                                  [--ids]
                                  [--resource-group]
                                  [--subscription]

Voorbeelden

Een ChangeRecord weergeven

az changesafety changerecord show -g MyResourceGroup -n changerecord001

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.

--change-record-name --name -n

De naam van de Resource ChangeRecord.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--subscription

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

Eigenschap Waarde
Parametergroep: Resource Id Arguments
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.

--verbose

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

Eigenschap Waarde
Default value: False

az changesafety changerecord update

Een bestaande ChangeRecord-resource bijwerken.

Gebruik deze opdracht om beschrijvende metagegevens, implementatie-instellingen of planning voor een bestaand ChangeRecord te wijzigen. Opmerking: de changeDefinition (doelen) kan niet worden gewijzigd na het maken.

az changesafety changerecord update [--acquire-policy-token]
                                    [--add]
                                    [--additional-data]
                                    [--anticipated-end-time]
                                    [--anticipated-start-time]
                                    [--change-record-name --name]
                                    [--change-reference]
                                    [--change-type {AppDeployment, Config, ManualTouch, PolicyDeployment}]
                                    [--comments]
                                    [--description]
                                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--ids]
                                    [--links]
                                    [--orchestration-tool]
                                    [--parameters]
                                    [--release-label]
                                    [--remove]
                                    [--resource-group]
                                    [--rollout-type {Emergency, Hotfix, Normal}]
                                    [--set]
                                    [--stage-map]
                                    [--stage-map-name --stagemap-name]
                                    [--subscription]

Voorbeelden

Implementatietype aanpassen en een opmerking toevoegen

az changesafety changerecord update -g MyResourceGroup -n changerecord001 --rollout-type Emergency --comments "Escalated to emergency rollout"

Planningsvenster bijwerken

az changesafety changerecord update -g MyResourceGroup -n changerecord001 --anticipated-start-time "2026-09-01T08:00:00Z" --anticipated-end-time "2026-09-01T12:00:00Z"

Beschrijving bijwerken

az changesafety changerecord update -g MyResourceGroup -n changerecord001 --description "Updated rollout for production deployment"

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.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string or JSON string>.

Eigenschap Waarde
Parametergroep: Generic Update Arguments
--additional-data

Aanvullende metagegevens voor de wijziging die vereist is voor verschillende indelingshulpprogramma's. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap Waarde
Parametergroep: Properties Arguments
--anticipated-end-time

Werk de verwachte voltooiingstijd bij in ISO 8601-indeling. Als u dit weglaat, blijft de huidige waarde behouden.

Eigenschap Waarde
Parametergroep: Properties Arguments
--anticipated-start-time

Werk de verwachte begintijd bij in ISO 8601-indeling. Als u dit weglaat, blijft de huidige waarde behouden.

Eigenschap Waarde
Parametergroep: Properties Arguments
--change-record-name --name -n

De naam van de Resource ChangeRecord.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap Waarde
Parametergroep: Global Policy Arguments
--change-type

Beschrijft de aard van de wijziging.

Eigenschap Waarde
Parametergroep: Properties Arguments
Geaccepteerde waarden: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Geef notities op over de meest recente update van ChangeRecord.

Eigenschap Waarde
Parametergroep: Properties Arguments
--description

Werk de beschrijving van de wijziging bij.

Eigenschap Waarde
Parametergroep: Properties Arguments
--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

Eigenschap Waarde
Parametergroep: Generic Update Arguments
Geaccepteerde waarden: 0, 1, f, false, n, no, t, true, y, yes
--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--links

Verzameling gerelateerde koppelingen voor de wijziging. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap Waarde
Parametergroep: Properties Arguments
--orchestration-tool

Hulpprogramma dat wordt gebruikt voor de implementatie van deze wijziging.

Eigenschap Waarde
Parametergroep: Properties Arguments
--parameters

Schema van parameters die worden opgegeven voor elke stageProgression. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap Waarde
Parametergroep: Properties Arguments
--release-label

Label voor de release die aan deze wijziging is gekoppeld.

Eigenschap Waarde
Parametergroep: Properties Arguments
--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.

Eigenschap Waarde
Parametergroep: Generic Update Arguments
--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Eigenschap Waarde
Parametergroep: Resource Id Arguments
--rollout-type

Beschrijft het type implementatie dat wordt gebruikt voor de wijziging.

Eigenschap Waarde
Parametergroep: Properties Arguments
Geaccepteerde waarden: Emergency, Hotfix, Normal
--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.

Eigenschap Waarde
Parametergroep: Generic Update Arguments
--stage-map

Verwijs naar een bestaande StageMap-resource met behulp van resource-id=RESOURCE_ID en optionele parameterssleutel=waardeparen.

Eigenschap Waarde
Parametergroep: Properties Arguments
--stage-map-name --stagemap-name

StageMap-naam in het huidige abonnementsbereik; de resource-id is voor u gebouwd.

Eigenschap Waarde
Parametergroep: Properties Arguments
--subscription

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

Eigenschap Waarde
Parametergroep: Resource Id Arguments
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.

--verbose

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

Eigenschap Waarde
Default value: False