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
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.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Id of the runbook execution.
Output path for the generated HTML editor (default: current directory).
Render from a local parameters (inputs.json) file instead of fetching from the service.
Name of the runbook.
Name of the Azure Migrate project. You can configure the default using az configure --defaults migrate_project=<name>.
Name of resource group. You can configure the default group using az configure --defaults group=<name>.
Optional local spec JSON file supplying the per-step entity list when rendering from --from-file.
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az migrate runbook execution parameter download
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
Id of the runbook execution.
Name of the runbook.
Name of the Azure Migrate project. You can configure the default using az configure --defaults migrate_project=<name>.
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.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Output directory for the downloaded parameter files (default: current directory).
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |
az migrate runbook execution parameter upload
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
Id of the runbook execution.
Path to the input-parameters JSON file to upload.
Name of the runbook.
Name of the Azure Migrate project. You can configure the default using az configure --defaults migrate_project=<name>.
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.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Global Parameters
Increase logging verbosity to show all debug logs.
| Property | Value |
|---|---|
| Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
| Property | Value |
|---|---|
| Default value: | False |
Output format.
| Property | Value |
|---|---|
| Default value: | json |
| Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
Increase logging verbosity. Use --debug for full debug logs.
| Property | Value |
|---|---|
| Default value: | False |