az migrate runbook execution parameter

Note

This reference is part of the migrate extension for the Azure CLI (version 2.75.0 or higher). The extension will automatically install the first time you run an az migrate runbook execution parameter command. Learn more about extensions.

Command group 'migrate runbook execution' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Download, upload, and configure an execution's input-parameters file.

Commands

Name Description Type Status
az migrate runbook execution parameter configure

Generate an offline HTML editor for an execution's parameters.

Extension Preview
az migrate runbook execution parameter download

Download an execution's parameters files.

Extension Preview
az migrate runbook execution parameter upload

Upload an execution's input-parameters file.

Extension Preview

az migrate runbook execution parameter configure

Preview

Command group 'migrate runbook execution parameter' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Generate an offline HTML editor for an execution's parameters.

Downloads the execution's inputs and renders a self-contained HTML page for editing them, with fields and validation driven by the schema in the parameters file. The page cannot call Azure; it writes inputs.json locally and shows the parameter upload command to run.

az migrate runbook execution parameter configure [--acquire-policy-token]
                                                 [--change-reference]
                                                 [--execution-id]
                                                 [--file]
                                                 [--from-file]
                                                 [--name --runbook-name]
                                                 [--project-name]
                                                 [--resource-group]
                                                 [--spec-file]

Examples

Open the parameters editor for an execution.

az migrate runbook execution parameter configure -g myRg \
  --project-name myProject --runbook-name myRunbook \
  --execution-id myExecution

Render from a local inputs.json without contacting Azure.

az migrate runbook execution parameter configure \
  --from-file ./inputs.json

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--execution-id

Id of the runbook execution.

--file

Output path for the generated HTML editor (default: current directory).

--from-file

Render from a local parameters (inputs.json) file instead of fetching from the service.

--name --runbook-name -n

Name of the runbook.

--project-name -p

Name of the Azure Migrate project. You can configure the default using az configure --defaults migrate_project=<name>.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--spec-file

Optional local spec JSON file supplying the per-step entity list when rendering from --from-file.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az migrate runbook execution parameter download

Preview

Command group 'migrate runbook execution parameter' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Download an execution's parameters files.

Downloads the parameters file (inputs.json) and, when the validation schema is shipped separately, schema.json, into a directory.

az migrate runbook execution parameter download --execution-id
                                                --name --runbook-name
                                                --project-name
                                                --resource-group
                                                [--acquire-policy-token]
                                                [--change-reference]
                                                [--directory]

Examples

Download the execution parameters files.

az migrate runbook execution parameter download -g myRg \
  --project-name myProject --runbook-name myRunbook \
  --execution-id myExecution --directory ./params

Required Parameters

--execution-id

Id of the runbook execution.

--name --runbook-name -n

Name of the runbook.

--project-name -p

Name of the Azure Migrate project. You can configure the default using az configure --defaults migrate_project=<name>.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--directory

Output directory for the downloaded parameter files (default: current directory).

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False

az migrate runbook execution parameter upload

Preview

Command group 'migrate runbook execution parameter' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Upload an execution's input-parameters file.

az migrate runbook execution parameter upload --execution-id
                                              --file
                                              --name --runbook-name
                                              --project-name
                                              --resource-group
                                              [--acquire-policy-token]
                                              [--change-reference]

Examples

Upload the execution input file.

az migrate runbook execution parameter upload -g myRg \
  --project-name myProject --runbook-name myRunbook \
  --execution-id myExecution --file ./input.json

Required Parameters

--execution-id

Id of the runbook execution.

--file

Path to the input-parameters JSON file to upload.

--name --runbook-name -n

Name of the runbook.

--project-name -p

Name of the Azure Migrate project. You can configure the default using az configure --defaults migrate_project=<name>.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property Value
Parameter group: Global Policy Arguments
--change-reference

The related change reference ID for this resource operation.

Property Value
Parameter group: Global Policy Arguments
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

Property Value
Default value: False
--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property Value
Default value: False
--output -o

Output format.

Property Value
Default value: json
Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property Value
Default value: False