你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az firmwareanalysis firmware

注意

此参考是 Azure CLI(版本 2.55.0 或更高版本)的固件分析扩展的一部分。 该扩展将在首次运行 az firmwareanalysis firmware 命令时自动安装。 详细了解扩展。

用于对特定固件执行操作的命令。

命令

名称 说明 类型 Status
az firmwareanalysis firmware binary-hardening

列出固件的二进制强化分析结果。

扩展 GA
az firmwareanalysis firmware create

创建新的固件。

扩展 GA
az firmwareanalysis firmware crypto-certificate

列出在固件中找到的加密证书分析结果。

扩展 GA
az firmwareanalysis firmware crypto-key

列出固件中发现的加密密钥分析结果。

扩展 GA
az firmwareanalysis firmware cve

列出固件的 CVE 分析结果。

扩展 GA
az firmwareanalysis firmware delete

删除固件。

扩展 GA
az firmwareanalysis firmware generate-filesystem-download-url

获取 tar 文件下载的 URL。

扩展 GA
az firmwareanalysis firmware list

列出工作区中的所有固件映像。

扩展 GA
az firmwareanalysis firmware password-hash

列出固件的密码哈希分析结果。

扩展 GA
az firmwareanalysis firmware sbom-component

列出固件的 SBOM 分析结果。

扩展 GA
az firmwareanalysis firmware show

获取固件。

扩展 GA
az firmwareanalysis firmware summary

按名称获取固件的分析结果摘要。

扩展 GA

az firmwareanalysis firmware binary-hardening

列出固件的二进制强化分析结果。

az firmwareanalysis firmware binary-hardening --firmware-id
                                              --resource-group
                                              --workspace-name
                                              [--max-items]
                                              [--next-token]

示例

列出固件的二进制强化分析结果。

az firmwareanalysis firmware binary-hardening --resource-group {ResourceGroupName} --workspace-name {workspaceName} --firmware-id {firmwareId}

必需参数

--firmware-id

固件的 ID。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--workspace-name

固件分析工作区的名称。

可选参数

--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的参数中 --next-token 提供令牌值。

--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az firmwareanalysis firmware create

创建新的固件。

az firmwareanalysis firmware create --resource-group
                                    --workspace-name
                                    [--description]
                                    [--file-name]
                                    [--file-size]
                                    [--firmware-id]
                                    [--model]
                                    [--status {Analyzing, Error, Extracting, Pending, Ready}]
                                    [--status-messages]
                                    [--vendor]
                                    [--version]

示例

创建新的固件。

az firmwareanalysis firmware create --resource-group {resourceGroupName} --workspace-name {workspaceName} --description {description} --file-name {fileName} --file-size {fileSize} --vendor {vendorName} --model {model} --version {version} --status {status} --status-messages ['hi','message']

必需参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--workspace-name

固件分析工作区的名称。

可选参数

--description

用户指定的固件说明。

--file-name

用户上传的固件的文件名。

--file-size

上传的固件映像的文件大小。

--firmware-id --name -n

固件的 ID。

默认值: 3f730021-daee-4951-b65a-d1039207a684
--model

固件模型。

--status

固件扫描的状态。

接受的值: Analyzing, Error, Extracting, Pending, Ready
默认值: Pending
--status-messages

固件分析期间生成的错误或其他消息列表支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。

--vendor

固件供应商。

--version

固件版本。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az firmwareanalysis firmware crypto-certificate

列出在固件中找到的加密证书分析结果。

az firmwareanalysis firmware crypto-certificate --firmware-id
                                                --resource-group
                                                --workspace-name
                                                [--max-items]
                                                [--next-token]

示例

列出在固件中找到的加密证书分析结果。

az firmwareanalysis firmware crypto-certificate --resource-group {ResourceGroupName} --workspace-name {workspaceName} --firmware-id {firmwareId}

必需参数

--firmware-id

固件的 ID。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--workspace-name

固件分析工作区的名称。

可选参数

--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的参数中 --next-token 提供令牌值。

--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az firmwareanalysis firmware crypto-key

列出固件中发现的加密密钥分析结果。

az firmwareanalysis firmware crypto-key --firmware-id
                                        --resource-group
                                        --workspace-name
                                        [--max-items]
                                        [--next-token]

示例

列出固件中发现的加密密钥分析结果。

az firmwareanalysis firmware crypto-key --resource-group {ResourceGroupName} --workspace-name {workspaceName} --firmware-id {firmwareId}

必需参数

--firmware-id

固件的 ID。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--workspace-name

固件分析工作区的名称。

可选参数

--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的参数中 --next-token 提供令牌值。

--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az firmwareanalysis firmware cve

列出固件的 CVE 分析结果。

az firmwareanalysis firmware cve --firmware-id
                                 --resource-group
                                 --workspace-name
                                 [--max-items]
                                 [--next-token]

示例

列出固件的 CVE 分析结果。

az az firmwareanalysis firmware cve --resource-group {ResourceGroupName} --workspace-name {workspaceName} --firmware-id {firmwareId}

必需参数

--firmware-id

固件的 ID。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--workspace-name

固件分析工作区的名称。

可选参数

--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的参数中 --next-token 提供令牌值。

--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az firmwareanalysis firmware delete

删除固件。

az firmwareanalysis firmware delete [--firmware-id]
                                    [--ids]
                                    [--resource-group]
                                    [--subscription]
                                    [--workspace-name]
                                    [--yes]

示例

删除固件。

az firmwareanalysis firmware delete --resource-group {ResourceGroupName} --workspace-name {workspaceName} --firmware-id {firmwareId}

可选参数

--firmware-id --name -n

固件的 ID。

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--workspace-name

固件分析工作区的名称。

--yes -y

不提示确认。

默认值: False
全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az firmwareanalysis firmware generate-filesystem-download-url

获取 tar 文件下载的 URL。

az firmwareanalysis firmware generate-filesystem-download-url [--firmware-id]
                                                              [--ids]
                                                              [--resource-group]
                                                              [--subscription]
                                                              [--workspace-name]

示例

获取 tar 文件下载的 URL。

az firmwareanalysis firmware generate-filesystem-download-url --resource-group {ResourceGroupName} --workspace-name {workspaceName} --firmware-id {firmwareId}

可选参数

--firmware-id

固件的 ID。

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--workspace-name

固件分析工作区的名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az firmwareanalysis firmware list

列出工作区中的所有固件映像。

az firmwareanalysis firmware list --resource-group
                                  --workspace-name
                                  [--max-items]
                                  [--next-token]

示例

列出工作区中的所有固件映像。

az firmwareanalysis firmware show --resource-group {ResourceGroupName} --workspace-name {workspaceName}

必需参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--workspace-name

固件分析工作区的名称。

可选参数

--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的参数中 --next-token 提供令牌值。

--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az firmwareanalysis firmware password-hash

列出固件的密码哈希分析结果。

az firmwareanalysis firmware password-hash --firmware-id
                                           --resource-group
                                           --workspace-name
                                           [--max-items]
                                           [--next-token]

示例

列出固件的密码哈希分析结果。

az firmwareanalysis firmware password-hash --resource-group {ResourceGroupName} --workspace-name {workspaceName} --firmware-id {firmwareId}

必需参数

--firmware-id

固件的 ID。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--workspace-name

固件分析工作区的名称。

可选参数

--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的参数中 --next-token 提供令牌值。

--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az firmwareanalysis firmware sbom-component

列出固件的 SBOM 分析结果。

az firmwareanalysis firmware sbom-component --firmware-id
                                            --resource-group
                                            --workspace-name
                                            [--max-items]
                                            [--next-token]

示例

列出固件的 SBOM 分析结果。

az firmwareanalysis firmware sbom-component --resource-group {ResourceGroupName} --workspace-name {workspaceName} --firmware-id {firmwareId}

必需参数

--firmware-id

固件的 ID。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--workspace-name

固件分析工作区的名称。

可选参数

--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的参数中 --next-token 提供令牌值。

--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az firmwareanalysis firmware show

获取固件。

az firmwareanalysis firmware show [--firmware-id]
                                  [--ids]
                                  [--resource-group]
                                  [--subscription]
                                  [--workspace-name]

示例

获取固件。

az firmwareanalysis firmware show --resource-group {ResourceGroupName} --workspace-name {workspaceName} --firmware-id {firmwareId}

可选参数

--firmware-id --name -n

固件的 ID。

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--workspace-name

固件分析工作区的名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az firmwareanalysis firmware summary

按名称获取固件的分析结果摘要。

az firmwareanalysis firmware summary [--firmware-id]
                                     [--ids]
                                     [--name {BinaryHardening, CVE, CryptoCertificate, CryptoKey, Firmware}]
                                     [--resource-group]
                                     [--subscription]
                                     [--workspace-name]

示例

按名称获取固件的分析结果摘要。

az firmwareanalysis firmware summary --resource-group {resourceGroupName} --workspace-name {workspaceName} --firmware-id {firmwareId} -n {analysisType}

可选参数

--firmware-id

固件的 ID。

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name --summary-name -n

描述摘要类型的固件分析摘要名称。

接受的值: BinaryHardening, CVE, CryptoCertificate, CryptoKey, Firmware
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--workspace-name

固件分析工作区的名称。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。