Freigeben über

az ams transform

Verwalten Von Transformationen für ein Azure Media Services-Konto.

Befehle

Name Beschreibung Typ Status
az ams transform create

Erstellen Sie eine Transformation.

 Core GA
az ams transform delete

Löschen einer Transformation.

 Core GA
az ams transform list

Listet alle Transformationen eines Azure Media Services-Kontos auf.

 Core GA
az ams transform output

Verwalten von Transformationsausgaben für ein Azure Media Services-Konto.

 Core GA
az ams transform output add

Fügen Sie einer vorhandenen Transformation eine Ausgabe hinzu.

 Core GA
az ams transform output remove

Entfernen sie eine Ausgabe aus einer vorhandenen Transformation.

 Core GA
az ams transform show

Zeigen Sie die Details einer Transformation an.

 Core GA
az ams transform update

Aktualisieren Sie die Details einer Transformation.

 Core GA

az ams transform create

Bearbeiten

Erstellen Sie eine Transformation.

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]

Beispiele

Erstellen Sie eine Transformation mit integrierter voreingestellter und hoher relativer Priorität für AdaptiveStreaming.

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

Erstellen Sie eine Transformation mit einer benutzerdefinierten Standard-Encoder-Voreinstellung aus einer JSON-Datei und niedriger relativer Priorität.

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

Erforderliche Parameter

--account-name -a

Der Name des Azure Media Services-Kontos.

--name -n

Der Name der Transformation.

--preset

Voreinstellung, die die Vorgänge beschreibt, die zum Ändern, Transcodieren oder Extrahieren von Erkenntnissen aus der Quelldatei verwendet werden, um die Transformationsausgabe zu generieren. Zulässige Werte: H264SingleBitrateSD, H264SingleBitrate720p, H264SingleBitrate1080p, AdaptiveStreaming, AACGoodQualityAudio, ContentAwareEncodingExperimental, ContentAwareEncoding, CopyAllBitrateNonInterleaved, H264MultipleBitrate1080p, H264MultipleBitrate720p, H264MultipleBitrateSD, H265ContentAwareEncoding, H265AdaptiveStreaming, H265SingleBitrate720p, H265SingleBitrate1080p, H265SingleBitrate4K, AudioAnalyzer, VideoAnalyzer, FaceDetector. Zusätzlich zu den zulässigen Werten können Sie auch einen Pfad zu einer benutzerdefinierten Standard Encoder-voreingestellten JSON-Datei übergeben. Weitere Informationen zu den Einstellungen, die zum Erstellen einer benutzerdefinierten Voreinstellung verwendet werden, finden Sie unter https://learn.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--audio-analysis-mode

Bestimmt den Satz der auszuführenden Audioanalysevorgänge. Wenn nicht angegeben, wird der Standard AudioAnalysisMode ausgewählt. Zulässige Werte: Standard, Einfach.

Eigenschaft Wert
Parameter group: Audio/Video Analyzer Arguments
--audio-language

Die Sprache für die Audionutzlast in der Eingabe mit dem BCP-47-Format "Language Tag-Region" (z. B. en-US). Wenn nicht angegeben, wird die automatische Spracherkennung eingesetzt. Dieses Feature unterstützt derzeit Englisch, Chinesisch, Französisch, Deutsch, Italienisch, Japanisch, Spanisch, Russisch und Portugiesisch. Die automatische Erkennung funktioniert am besten mit Audioaufzeichnungen mit klar erkennbarer Sprache. Wenn die automatische Erkennung die Sprache nicht findet, würde die Transkription auf Englisch zurückfallen. Zulässige Werte: 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.

Eigenschaft Wert
Parameter group: Audio/Video Analyzer Arguments
--blur-type

Zulässige Werte: Box, Niedrig, Med, Hoch, Schwarz.

Eigenschaft Wert
Parameter group: Face Detector Arguments
--description

Die Beschreibung der Transformation.

--face-detector-mode

Dieser Modus bietet die Möglichkeit, zwischen den folgenden Einstellungen auszuwählen: 1) Analysieren – Nur zur Erkennung. Dieser Modus generiert eine JSON-Metadatendatei, die die Darstellung von Gesichtern im gesamten Video kennzeichnet. Erscheinungsbilde derselben Person werden soweit möglich mit derselben ID versehen. 2) Kombiniert - Zusätzlich werden Gesichter (Weichzeichner) erkannt. 3) Redact - Dies ermöglicht einen 2-Pass-Prozess, sodass selektive Redaction einer Teilmenge von erkannten Gesichtern ermöglicht wird. Sie übernimmt die Metadatendatei aus einem vorherigen Analysedurchlauf zusammen mit dem Quellvideo und einer vom Benutzer ausgewählten Teilmenge von IDs, die Eine Redaction erfordern. Zulässige Werte: Analysieren, Redact, Combined.

Eigenschaft Wert
Parameter group: Face Detector Arguments
--insights-to-extract

Die Art der zu extrahierenden Erkenntnisse. Wenn sie nicht festgelegt ist, wird der Typ basierend auf dem Inhaltstyp ausgewählt. Wenn der Inhalt nur Audio ist, werden nur Audioeinblicke extrahiert, und wenn es sich um Videoeinblicke handelt, werden nur Videoeinblicke extrahiert.

Eigenschaft Wert
Parameter group: Video Analyzer Arguments
Zulässige Werte: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--on-error

Eine Transformation kann mehrere Ausgaben definieren. Diese Eigenschaft definiert, was der Dienst tun soll, wenn eine Ausgabe fehlschlägt – entweder weiterhin andere Ausgaben erzeugen oder die anderen Ausgaben beenden. Der Gesamtauftragsstatus spiegelt keine Fehler von Ausgaben wider, die mit "ContinueJob" angegeben sind. Der Standardwert ist "StopProcessingJob".

Eigenschaft Wert
Zulässige Werte: ContinueJob, StopProcessingJob
--relative-priority

Legt die relative Priorität der Transformationsausgabe innerhalb einer Transformation fest. Dadurch wird die Priorität festgelegt, die der Dienst für die Verarbeitung von TransformOutputs verwendet. Die Standardpriorität ist "Normal".

Eigenschaft Wert
Zulässige Werte: High, Low, Normal
--resolution

Gibt die maximale Auflösung an, mit der Ihr Video analysiert wird. Das Standardverhalten ist "SourceResolution", wodurch das Eingabevideo bei der Analyse bei der ursprünglichen Auflösung erhalten bleibt. Die Verwendung von StandardDefinition ändert die Größe von Eingabevideos in standarddefinitionen, wobei das entsprechende Seitenverhältnis beibehalten wird. Die Größe wird nur geändert, wenn das Video eine höhere Auflösung hat. Beispielsweise würde eine Eingabe von 1920 x 1080 vor der Verarbeitung auf 640 x 360 skaliert werden. Durch den Wechsel zu "StandardDefinition" wird die Zeit reduziert, die zum Verarbeiten von Videos mit hoher Auflösung benötigt wird. Sie kann auch die Kosten für die Verwendung dieser Komponente reduzieren (einzelheiten hierzu finden Sie unter https://azure.microsoft.com/pricing/details/media-services/#analytics). Gesichter, die in dem video mit geänderter Größe zu klein sind, werden jedoch möglicherweise nicht erkannt. Zulässige Werte: StandardDefinition, SourceResolution.

Eigenschaft Wert
Parameter group: Face Detector Arguments
--video-analysis-mode

Bestimmt den Satz der auszuführenden Audioanalysevorgänge. Wenn nicht angegeben, wird der Standard AudioAnalysisMode ausgewählt. Zulässige Werte: Standard, Einfach.

Eigenschaft Wert
Parameter group: Video Analyzer Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az ams transform delete

Bearbeiten

Löschen einer Transformation.

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

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-name -a

Der Name des Azure Media Services-Kontos.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--name -n

Der Name der Transformation.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az ams transform list

Bearbeiten

Listet alle Transformationen eines Azure Media Services-Kontos auf.

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

Erforderliche Parameter

--account-name -a

Der Name des Azure Media Services-Kontos.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--filter

Schränkt den Satz der zurückgegebenen Elemente ein.

--orderby

Gibt den Schlüssel an, nach dem die Ergebnisauflistung sortiert werden soll.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az ams transform show

Bearbeiten

Zeigen Sie die Details einer Transformation an.

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

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-name -a

Der Name des Azure Media Services-Kontos.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--name -n

Der Name der Transformation.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az ams transform update

Bearbeiten

Aktualisieren Sie die Details einer Transformation.

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

Beispiele

Aktualisieren Sie die erste Transformationsausgabe einer Transformation, indem Sie die relative Priorität auf "Hoch" festlegen.

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

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-name -a

Der Name des Azure Media Services-Kontos.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: []
--description

Die Beschreibung der Transformation.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: False
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--name -n

Der Name der Transformation.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: []
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Eigenschaft Wert
Parameter group: Generic Update Arguments
Standardwert: []
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parameter group: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Output format.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False