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

az ams transform output

参考

管理 Azure 媒体服务帐户的转换输出。

命令

名称	说明	类型	Status
az ams transform output add	将输出添加到现有转换。	核心	加语
az ams transform output remove	从现有转换中删除输出。	核心	加语

az ams transform output add

编辑

将输出添加到现有转换。

az ams transform output add --preset
                            [--account-name]
                            [--audio-analysis-mode]
                            [--audio-language]
                            [--blur-type]
                            [--face-detector-mode]
                            [--ids]
                            [--insights-to-extract {AllInsights, AudioInsightsOnly, VideoInsightsOnly}]
                            [--name]
                            [--on-error {ContinueJob, StopProcessingJob}]
                            [--relative-priority {High, Low, Normal}]
                            [--resolution]
                            [--resource-group]
                            [--subscription]
                            [--video-analysis-mode]

示例

使用 JSON 文件中的自定义标准编码器预设添加输出。

az ams transform output add -a myAmsAccount -n transformName -g myResourceGroup --preset "C:\MyPresets\CustomPreset.json"

使用 VideoAnalyzer 预设添加输出，es-ES 为音频语言，并且仅使用音频见解。

az ams transform output add -a myAmsAccount -n transformName -g myResourceGroup --preset VideoAnalyzer --audio-language es-ES --insights-to-extract AudioInsightsOnly

必需参数

--preset

描述将用于修改、转码或从源文件中提取见解以生成转换输出的操作的预设。允许的值：H264SingleBitrateSD、H264SingleBitrate720p、H264SingleBitrate1080p、AdaptiveStreaming、AACGoodQualityAudio、ContentAwareEncodingExperimental、ContentAwareEncoding、CopyAllBitrateNonInterleaved、H264MultipleBitrate1080p、 H264MultipleBitrate720p、H264MultipleBitrateSD、H265ContentAwareEncoding、H265AdaptiveStreaming、H265SingleBitrate720p、H265SingleBitrate1080p、H265SingleBitrate4K、AudioAnalyzer、VideoAnalyzer、FaceDetector。除了允许的值，还可以将路径传递给自定义标准编码器预设 JSON 文件。有关用于生成自定义预设的设置的更多详细信息，请参阅 https://learn.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset。

可选参数

--account-name -a

Azure 媒体服务帐户的名称。

--audio-analysis-mode

确定要执行的音频分析操作集。如果未指定，则会选择标准 AudioAnalysisMode。允许的值：标准值、基本值。

--audio-language

使用 BCP-47 格式的“语言标记区域”（例如 en-US）输入中的音频有效负载的语言。如果未指定，将采用自动语言检测。此功能目前支持英语、中文、法语、德语、意大利语、日语、西班牙语、俄语和葡萄牙语。自动检测最适用于具有清晰辨别语音的录音。如果自动检测找不到语言，则听录将回退到英语。允许的值：en-US、en-GB、es-ES、es-MX、fr-FR、it-IT、ja-JP、pt-BR、zh-CN、de-DE、ar-EG、ru-RU、hi-IN。

--blur-type

允许的值：Box、Low、Med、High、Black。

--face-detector-mode

此模式提供在以下设置之间进行选择的功能：1）分析 - 仅用于检测。此模式生成元数据 JSON 文件，用于标记整个视频中人脸的外观。如果可能，同一人的外观将分配相同的 ID。2）组合 - 此外，检测到人脸的编辑（模糊）。 3）修订 - 这可实现 2 次传递过程，允许选择性地编辑检测到的人脸子集。它采用先前分析传递中的元数据文件以及源视频，以及需要修订的用户选择的 ID 子集。允许的值：分析、修订、组合。

--ids

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

--insights-to-extract

要提取的见解类型。如果未设置，则将根据内容类型选择类型。如果仅内容为音频，则仅提取音频见解，并且仅提取视频见解。

接受的值: AllInsights, AudioInsightsOnly, VideoInsightsOnly

--name -n

转换的名称。

--on-error

转换可以定义多个输出。此属性定义服务在一个输出失败时应执行的操作 - 继续生成其他输出，或者停止其他输出。总体作业状态不会反映使用“ContinueJob”指定的输出失败。默认值为“StopProcessingJob”。

接受的值: ContinueJob, StopProcessingJob

--relative-priority

设置转换输出在转换中的相对优先级。这会设置服务用于处理 TransformOutputs 的优先级。默认优先级为 Normal。

接受的值: High, Low, Normal

--resolution

指定分析视频的最大分辨率。默认行为为“SourceResolution”，在分析时将输入视频保留为其原始分辨率。使用 StandardDefinition 会将输入视频的大小调整为标准定义，同时保留适当的纵横比。仅当视频分辨率较高时，它才会调整大小。例如，在处理之前，1920x1080 输入将缩放为 640x360。切换到“StandardDefinition”可以减少处理高分辨率视频所需的时间。它还可能会降低使用此组件的成本（有关详细信息，请参阅 https://azure.microsoft.com/pricing/details/media-services/#analytics）。但是，可能无法检测到在调整大小的视频中最终太小的人脸。允许的值：StandardDefinition、SourceResolution。

--resource-group -g

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

--subscription

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

--video-analysis-mode

确定要执行的音频分析操作集。如果未指定，则会选择标准 AudioAnalysisMode。允许的值：标准值、基本值。

全局参数

--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 ams transform output remove

编辑

从现有转换中删除输出。

az ams transform output remove --output-index
                               [--account-name]
                               [--ids]
                               [--name]
                               [--resource-group]
                               [--subscription]

示例

删除使用 --output-index 参数指定的索引处的输出元素。

az ams transform output remove -a myAmsAccount -n transformName -g myResourceGroup --output-index 1

必需参数

--output-index

要移除的输出的元素索引。

可选参数

--account-name -a

Azure 媒体服务帐户的名称。

--ids

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

--name -n

转换的名称。

--resource-group -g

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

--subscription

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

全局参数

--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 ams transform output

命令

az ams transform output add

示例

必需参数

可选参数

az ams transform output remove

示例

必需参数

可选参数

其他资源