Freigeben über

az ams transform

  • Referenz

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

Befehle

Name Beschreibung Typ Status
az ams transform create

Erstellen Sie eine Transformation.

 Core Allgemein verfügbar
az ams transform delete

Löschen einer Transformation.

 Core Allgemein verfügbar
az ams transform list

Listet alle Transformationen eines Azure Media Services-Kontos auf.

 Core Allgemein verfügbar
az ams transform output

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

 Core Allgemein verfügbar
az ams transform output add

Fügen Sie einer vorhandenen Transformation eine Ausgabe hinzu.

 Core Allgemein verfügbar
az ams transform output remove

Entfernen sie eine Ausgabe aus einer vorhandenen Transformation.

 Core Allgemein verfügbar
az ams transform show

Zeigen Sie die Details einer Transformation an.

 Core Allgemein verfügbar
az ams transform update

Aktualisieren Sie die Details einer Transformation.

 Core Allgemein verfügbar

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 sollen, finden Sie https://docs.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset unter

--resource-group -g

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

Optionale Parameter

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

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

--blur-type

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

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

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

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

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

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

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

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az ams transform delete

Bearbeiten

Löschen einer Transformation.

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

Optionale Parameter

--account-name -a

Der Name des Azure Media Services-Kontos.

--ids

Eine oder mehrere 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.

--name -n

Der Name der Transformation.

--resource-group -g

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

--account-name -a

Der Name des Azure Media Services-Kontos.

--ids

Eine oder mehrere 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.

--name -n

Der Name der Transformation.

--resource-group -g

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

--account-name -a

Der Name des Azure Media Services-Kontos.

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

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.

Standardwert: False
--ids

Eine oder mehrere 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.

--name -n

Der Name der Transformation.

--remove

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

Standardwert: []
--resource-group -g

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

--set

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

Standardwert: []
--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

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

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.