你当前正在访问 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。

默认值: 5d852da1-7d39-43b7-8744-b075c7d17220

--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

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

全局参数

--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

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

全局参数

--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

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

全局参数

--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

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

全局参数

--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

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

全局参数

--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

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

全局参数

--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 获取完整的调试日志。

通过

az firmwareanalysis firmware

命令

az firmwareanalysis firmware binary-hardening

示例

必需参数

可选参数

az firmwareanalysis firmware create

示例

必需参数

可选参数

az firmwareanalysis firmware crypto-certificate

示例

必需参数

可选参数

az firmwareanalysis firmware crypto-key

示例

必需参数

可选参数

az firmwareanalysis firmware cve

示例

必需参数

可选参数

az firmwareanalysis firmware delete

示例

可选参数

az firmwareanalysis firmware generate-filesystem-download-url

示例

可选参数

az firmwareanalysis firmware list

示例

必需参数

可选参数

az firmwareanalysis firmware password-hash

示例

必需参数

可选参数

az firmwareanalysis firmware sbom-component

示例

必需参数

可选参数

az firmwareanalysis firmware show

示例

可选参数

az firmwareanalysis firmware summary

示例

可选参数

其他资源