az changesafety changerecord

Note

Den här referensen är en del av azure-changesafety-tillägget för Azure CLI (version 2.75.0 eller senare). Tillägget installeras automatiskt första gången du kör kommandot az changesafety changerecord . Läs mer om tillägg.

Hantera ChangeRecord-resurser som beskriver planerade ändringar mellan mål.

Kommandon

Name Description Typ Status
az changesafety changerecord create

Skapa en ChangeRecord-resurs.

 Extension GA
az changesafety changerecord delete

Ta bort en ChangeRecord-resurs.

 Extension GA
az changesafety changerecord list

Lista ChangeRecord-resurser.

 Extension GA
az changesafety changerecord show

Visa information för en ChangeRecord-resurs.

 Extension GA
az changesafety changerecord update

Uppdatera en befintlig ChangeRecord-resurs.

 Extension GA

az changesafety changerecord create

Skapa en ChangeRecord-resurs.

Ange minst en måldefinition för att beskriva vilka resurser eller åtgärder som ChangeRecord kommer att påverka. Målen uttrycks som komma- eller semikolonavgränsade nyckel=värdepar som resourceId=RESOURCE_ID,operation=DELETE. Kommandot är också tillgängligt via aliaset az changesafety changerecord. Om du utelämnar schemaläggningsflaggor är den förväntade starttiden som standard nu och den förväntade sluttiden är som standard åtta timmar senare (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]

Exempel

Skapa en ChangeRecord för att ta bort en Traffic Manager-profil

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"

Referera till en StageMap efter namn

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"

Skapa med stagemap-referens och statuslänk

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

Skapa i prenumerationsomfång (ingen resursgrupp)

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

Obligatoriska parametrar

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

Namnet på resursen ChangeRecord.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--additional-data

Ytterligare metadata för den ändring som krävs för olika orkestreringsverktyg. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

Egenskap Värde
Parametergrupp: Properties Arguments
--anticipated-end-time

Förväntad slutförandetid i ISO 8601-format. Standardvärdet är åtta timmar efter den förväntade starttiden när den utelämnas.

Egenskap Värde
Parametergrupp: Properties Arguments
--anticipated-start-time

Förväntad starttid i ISO 8601-format. Standardvärdet är aktuell UTC-tid när den utelämnas.

Egenskap Värde
Parametergrupp: Properties Arguments
--change-definition

Ändra begärandetext och/eller kriterier för resursval som används för att identifiera målresurserna. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

Egenskap Värde
Parametergrupp: Properties Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-type

Klassificera ändringen, till exempel AppDeployment, Config, ManualTouch eller PolicyDeployment.

Egenskap Värde
Parametergrupp: Properties Arguments
Godkända värden: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Kommentarer om den senaste uppdateringen av ChangeRecord-resursen.

Egenskap Värde
Parametergrupp: Properties Arguments
--description

En beskrivning av ändringen som utförs.

Egenskap Värde
Parametergrupp: Properties Arguments
--links

Lägg till stödlänkar genom att upprepa --links name=NAME uri=URL [description=TEXT].

Egenskap Värde
Parametergrupp: Properties Arguments
--orchestration-tool

Verktyg som används för distributionsorkestrering av den här ändringen.

Egenskap Värde
Parametergrupp: Properties Arguments
--parameters

Schema för parametrar som ska anges för varje stegProgression. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

Egenskap Värde
Parametergrupp: Properties Arguments
--release-label

Etikett för den version som är associerad med den här ändringen.

Egenskap Värde
Parametergrupp: Properties Arguments
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--rollout-type

Ange distributionstypen (Normal, Snabbkorrigering eller Nödsituation).

Egenskap Värde
Parametergrupp: Properties Arguments
Godkända värden: Emergency, Hotfix, Normal
--stage-map

Referera till en befintlig StageMap-resurs med hjälp av resource-id=RESOURCE_ID och valfria parametrar key=value pairs.

Egenskap Värde
Parametergrupp: Properties Arguments
--stage-map-name --stagemap-name

StageMap-namn i det aktuella prenumerationsomfånget. resurs-ID:t har skapats åt dig.

Egenskap Värde
Parametergrupp: Properties Arguments
--targets

En eller flera måldefinitioner uttryckta som key=value pairs (till exempel resourceId=RESOURCE_ID,operation=DELETE,resourceType=Microsoft.Compute/virtualMachines).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az changesafety changerecord delete

Ta bort en ChangeRecord-resurs.

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

Exempel

Ta bort en ChangeRecord utan bekräftelse

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-record-name --name -n

Namnet på resursen ChangeRecord.

Egenskap Värde
Parametergrupp: Resource Id Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.

Egenskap Värde
Parametergrupp: Resource Id Arguments
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Egenskap Värde
Parametergrupp: Resource Id Arguments
--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Egenskap Värde
Parametergrupp: Resource Id Arguments
--yes -y

Fråga inte efter bekräftelse.

Egenskap Värde
Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az changesafety changerecord list

Lista ChangeRecord-resurser.

Visa en lista över alla ChangeRecord-resurser i en prenumeration eller resursgrupp.

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

Exempel

Visa en lista över alla ChangeRecords i den aktuella prenumerationen

az changesafety changerecord list

Lista ChangeRecords i en specifik resursgrupp

az changesafety changerecord list -g MyResourceGroup

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--max-items

Totalt antal objekt som ska returneras i kommandots utdata. Om det totala antalet tillgängliga objekt är mer än det angivna värdet anges en token i kommandots utdata. Om du vill återuppta sidnumreringen anger du tokenvärdet i --next-token argument för ett efterföljande kommando.

Egenskap Värde
Parametergrupp: Pagination Arguments
--next-token

Token för att ange var sidnumrering ska börja. Detta är tokenvärdet från ett tidigare trunkerat svar.

Egenskap Värde
Parametergrupp: Pagination Arguments
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az changesafety changerecord show

Visa information för en ChangeRecord-resurs.

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

Exempel

Visa en ChangeRecord

az changesafety changerecord show -g MyResourceGroup -n changerecord001

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

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

Namnet på resursen ChangeRecord.

Egenskap Värde
Parametergrupp: Resource Id Arguments
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.

Egenskap Värde
Parametergrupp: Resource Id Arguments
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Egenskap Värde
Parametergrupp: Resource Id Arguments
--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Egenskap Värde
Parametergrupp: Resource Id Arguments
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az changesafety changerecord update

Uppdatera en befintlig ChangeRecord-resurs.

Använd det här kommandot för att ändra beskrivande metadata, distributionsinställningar eller schemaläggning för en befintlig ChangeRecord. Obs! ChangeDefinition (mål) kan inte ändras efter skapandet.

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]

Exempel

Justera distributionstypen och lägg till en kommentar

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

Uppdatera schemaläggningsfönstret

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

Uppdateringsbeskrivning

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

Egenskap Värde
Parametergrupp: Generic Update Arguments
--additional-data

Ytterligare metadata för den ändring som krävs för olika orkestreringsverktyg. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

Egenskap Värde
Parametergrupp: Properties Arguments
--anticipated-end-time

Uppdatera den förväntade slutförandetiden i ISO 8601-format. Om det utelämnas bevaras det aktuella värdet.

Egenskap Värde
Parametergrupp: Properties Arguments
--anticipated-start-time

Uppdatera den förväntade starttiden i ISO 8601-format. Om det utelämnas bevaras det aktuella värdet.

Egenskap Värde
Parametergrupp: Properties Arguments
--change-record-name --name -n

Namnet på resursen ChangeRecord.

Egenskap Värde
Parametergrupp: Resource Id Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-type

Beskriver ändringens natur.

Egenskap Värde
Parametergrupp: Properties Arguments
Godkända värden: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

Ange information om den senaste uppdateringen av ChangeRecord.

Egenskap Värde
Parametergrupp: Properties Arguments
--description

Uppdatera beskrivningen av ändringen.

Egenskap Värde
Parametergrupp: Properties Arguments
--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

Egenskap Värde
Parametergrupp: Generic Update Arguments
Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.

Egenskap Värde
Parametergrupp: Resource Id Arguments
--links

Samling relaterade länkar för ändringen. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

Egenskap Värde
Parametergrupp: Properties Arguments
--orchestration-tool

Verktyg som används för distributionsorkestrering av den här ändringen.

Egenskap Värde
Parametergrupp: Properties Arguments
--parameters

Schema för parametrar som ska anges för varje stegProgression. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

Egenskap Värde
Parametergrupp: Properties Arguments
--release-label

Etikett för den version som är associerad med den här ändringen.

Egenskap Värde
Parametergrupp: Properties Arguments
--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

Egenskap Värde
Parametergrupp: Generic Update Arguments
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Egenskap Värde
Parametergrupp: Resource Id Arguments
--rollout-type

Beskriver typen av distribution som används för ändringen.

Egenskap Värde
Parametergrupp: Properties Arguments
Godkända värden: Emergency, Hotfix, Normal
--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

Egenskap Värde
Parametergrupp: Generic Update Arguments
--stage-map

Referera till en befintlig StageMap-resurs med hjälp av resource-id=RESOURCE_ID och valfria parametrar key=value pairs.

Egenskap Värde
Parametergrupp: Properties Arguments
--stage-map-name --stagemap-name

StageMap-namn i det aktuella prenumerationsomfånget. resurs-ID:t har skapats åt dig.

Egenskap Värde
Parametergrupp: Properties Arguments
--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Egenskap Värde
Parametergrupp: Resource Id Arguments
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False