az ams transform

參考

管理 Azure 媒體服務帳戶的轉換。

命令

名稱	Description	類型	狀態
az ams transform create	建立轉換。	核心	加語
az ams transform delete	刪除轉換。	核心	加語
az ams transform list	列出 Azure 媒體服務帳戶的所有轉換。	核心	加語
az ams transform output	管理 Azure 媒體服務帳戶的轉換輸出。	核心	加語
az ams transform output add	將輸出新增至現有的轉換。	核心	加語
az ams transform output remove	從現有的轉換中移除輸出。	核心	加語
az ams transform show	顯示轉換的詳細數據。	核心	加語
az ams transform update	更新轉換的詳細數據。	核心	加語

az ams transform create

編輯

建立轉換。

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

範例

使用 AdaptiveStreaming 內建預設和高相對優先順序建立轉換。

az ams transform create -a myAmsAccount -n transformName -g myResourceGroup --preset AdaptiveStreaming --relative-priority High

從 JSON 檔案建立具有自訂標準編碼器預設值和低相對優先順序的轉換。

az ams transform create -a myAmsAccount -n transformName -g myResourceGroup --preset "C:\MyPresets\CustomPreset.json" --relative-priority Low

必要參數

--account-name -a

Azure 媒體服務帳戶的名稱。

--name -n

轉換的名稱。

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

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<name>來設定預設群組。

選擇性參數

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

--description

轉換的描述。

--face-detector-mode

此模式可讓您選擇下列設定：1）分析 - 僅供偵測。此模式會產生元數據 JSON 檔案，以標記整個影片中臉部的外觀。可能的話，同一人的外觀會指派相同的標識碼。2）合併 - 此外，偵測到臉部的修訂（模糊）。 3）修訂 - 這可啟用 2 階段程式，允許選擇性修訂偵測到臉部子集。它會從先前的分析階段擷取元數據檔案，以及來源影片，以及需要修訂的用戶選取標識子集。允許的值：分析、修訂、合併。

--insights-to-extract

要擷取的深入解析類型。如果未設定，則會根據內容類型選取類型。如果內容只是音訊，則只會擷取音頻深入解析，如果它是僅限視訊深入解析，則會擷取影片深入解析。

接受的值: AllInsights, AudioInsightsOnly, VideoInsightsOnly

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

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

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。針對完整偵錯記錄使用 --debug。

az ams transform delete

編輯

刪除轉換。

az ams transform delete [--account-name]
                        [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

選擇性參數

--account-name -a

Azure 媒體服務帳戶的名稱。

--ids

一或多個資源識別碼（以空格分隔）。它應該是包含「資源標識碼」自變數所有資訊的完整資源識別碼。您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

轉換的名稱。

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<name>來設定預設群組。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 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

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。針對完整偵錯記錄使用 --debug。

az ams transform list

編輯

列出 Azure 媒體服務帳戶的所有轉換。

az ams transform list --account-name
                      --resource-group
                      [--filter]
                      [--orderby]

必要參數

--account-name -a

Azure 媒體服務帳戶的名稱。

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<name>來設定預設群組。

選擇性參數

--filter

限制傳回的專案集。

--orderby

指定應該排序結果集合的索引鍵。

全域參數

--debug

增加記錄詳細信息以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。針對完整偵錯記錄使用 --debug。

az ams transform show

編輯

顯示轉換的詳細數據。

az ams transform show [--account-name]
                      [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

選擇性參數

--account-name -a

Azure 媒體服務帳戶的名稱。

--ids

--name -n

轉換的名稱。

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<name>來設定預設群組。

--subscription

訂用帳戶的名稱或標識碼。您可以使用 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

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。針對完整偵錯記錄使用 --debug。

az ams transform update

編輯

更新轉換的詳細數據。

az ams transform update [--account-name]
                        [--add]
                        [--description]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

範例

將轉換的相對優先順序設定為 High，以更新轉換的第一個轉換輸出。

az ams transform update -a myAmsAccount -n transformName -g myResourceGroup --set outputs[0].relativePriority=High

選擇性參數

--account-name -a

Azure 媒體服務帳戶的名稱。

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []

--description

轉換的描述。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

預設值: False

--ids

--name -n

轉換的名稱。

--remove

從清單中移除屬性或專案。範例：--remove property.list <indexToRemove> OR --remove propertyToRemove。

預設值: []

--resource-group -g

資源組名。您可以使用 az configure --defaults group=<name>來設定預設群組。

--set

指定要設定的屬性路徑和值，以更新物件。範例：--set property1.property2=<value>。

預設值: []

--subscription

訂用帳戶的名稱或標識碼。您可以使用 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

訂用帳戶的名稱或標識碼。您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。針對完整偵錯記錄使用 --debug。

共用方式為

az ams transform

命令

az ams transform create

範例

必要參數

選擇性參數

az ams transform delete

選擇性參數

az ams transform list

必要參數

選擇性參數

az ams transform show

選擇性參數

az ams transform update

範例

選擇性參數

其他資源