Delen via

az ams transform

  • Referentie

Transformaties voor een Azure Media Services-account beheren.

Opdracht

Name Description Type Status
az ams transform create

Een transformatie maken.

 Kern GA
az ams transform delete

Een transformatie verwijderen.

 Kern GA
az ams transform list

Alle transformaties van een Azure Media Services-account weergeven.

 Kern GA
az ams transform output

Transformatie-uitvoer voor een Azure Media Services-account beheren.

 Kern GA
az ams transform output add

Voeg een uitvoer toe aan een bestaande transformatie.

 Kern GA
az ams transform output remove

Verwijder een uitvoer uit een bestaande transformatie.

 Kern GA
az ams transform show

De details van een transformatie weergeven.

 Kern GA
az ams transform update

Werk de details van een transformatie bij.

 Kern GA

az ams transform create

Bewerken

Een transformatie maken.

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]

Voorbeelden

Maak een transformatie met adaptiveStreaming ingebouwde vooraf ingestelde en hoge relatieve prioriteit.

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

Maak een transformatie met een aangepaste standaard coderingsprogramma vooraf ingesteld op basis van een JSON-bestand en lage relatieve prioriteit.

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

Vereiste parameters

--account-name -a

De naam van het Azure Media Services-account.

--name -n

De naam van de transformatie.

--preset

Vooraf ingesteld waarmee de bewerkingen worden beschreven die worden gebruikt voor het wijzigen, transcoderen of extraheren van inzichten uit het bronbestand om de transformatie-uitvoer te genereren. Toegestane waarden: H264SingleBitrateSD, H264SingleBitrate720p, H264SingleBitrate1080p, AdaptiveStreaming, AACGoodQualityAudio, ContentAwareEncodingExperimental, ContentAwareEncoding, CopyAllBitrateNonInterleaved, H264MultipleBitrate1080p, H264MultipleBitrate720p, H264MultipleBitrateSD, H265ContentAwareEncoding, H265AdaptiveStreaming, H265SingleBitrate720p, H265SingleBitrate1080p, H265SingleBitrate4K, AudioAnalyzer, VideoAnalyzer, FaceDetector. Naast de toegestane waarden kunt u ook een pad doorgeven naar een aangepast, vooraf ingestelde JSON-bestand van de Standard Encoder. Zie https://learn.microsoft.com/rest/api/media/transforms/createorupdate#standardencoderpreset voor meer informatie over de instellingen die u kunt gebruiken om een aangepaste voorinstelling te maken.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--audio-analysis-mode

Bepaalt de set audioanalysebewerkingen die moeten worden uitgevoerd. Indien niet opgegeven, wordt de Standaard AudioAnalysisMode gekozen. Toegestane waarden: Standard, Basic.

--audio-language

De taal voor de audiopayload in de invoer met behulp van de BCP-47-indeling van 'language tag-region' (bijvoorbeeld en-US). Als dit niet is opgegeven, wordt automatische taaldetectie gebruikt. Deze functie ondersteunt momenteel Engels, Chinees, Frans, Duits, Italiaans, Japans, Spaans, Russisch en Portugees. De automatische detectie werkt het beste met audio-opnamen met duidelijk te onderscheiden spraak. Als automatische detectie de taal niet kan vinden, zou transcriptie terugvallen op Engels. Toegestane waarden: 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

Toegestane waarden: Box, Low, Med, High, Black.

--description

De beschrijving van de transformatie.

--face-detector-mode

Deze modus biedt de mogelijkheid om te kiezen tussen de volgende instellingen: 1) Analyseren - alleen voor detectie. In deze modus wordt een JSON-bestand met metagegevens gegenereerd dat het uiterlijk van gezichten in de video markeert. Indien mogelijk krijgen verschijningen van dezelfde persoon dezelfde id toegewezen. 2) Gecombineerd- Daarnaast worden gezichten (vervagen) gedetecteerde gezichten. 3) Redact : hiermee wordt een proces met twee pass-bewerkingen ingeschakeld, waardoor selectief een subset van gedetecteerde gezichten kan worden bewerkt. Het neemt het metagegevensbestand op van een eerdere analysepass, samen met de bronvideo en een door de gebruiker geselecteerde subset van id's waarvoor redaction is vereist. Toegestane waarden: Analyseren, Redact, Gecombineerd.

--insights-to-extract

Het type inzichten dat moet worden geëxtraheerd. Als dit niet is ingesteld, wordt het type geselecteerd op basis van het inhoudstype. Als de inhoud alleen audio is, worden alleen audio-inzichten geëxtraheerd en worden alleen video-inzichten geëxtraheerd.

Geaccepteerde waarden: AllInsights, AudioInsightsOnly, VideoInsightsOnly
--on-error

Een transformatie kan meer dan één uitvoer definiëren. Met deze eigenschap wordt gedefinieerd wat de service moet doen wanneer de ene uitvoer mislukt. U kunt ook andere uitvoer blijven produceren of de andere uitvoer stoppen. De algehele taakstatus geeft geen fouten weer van uitvoer die zijn opgegeven met ContinueJob. De standaardwaarde is 'StopProcessingJob'.

Geaccepteerde waarden: ContinueJob, StopProcessingJob
--relative-priority

Hiermee stelt u de relatieve prioriteit van de transformatieuitvoer in een transformatie in. Hiermee stelt u de prioriteit in die de service gebruikt voor het verwerken van TransformOutputs. De standaardprioriteit is Normaal.

Geaccepteerde waarden: High, Low, Normal
--resolution

Hiermee geeft u de maximale resolutie waarop uw video wordt geanalyseerd. Het standaardgedrag is 'SourceResolution', waarmee de invoervideo op de oorspronkelijke resolutie wordt bewaard wanneer deze wordt geanalyseerd. Met Behulp van StandardDefinition wordt het formaat van invoervideo's aangepast aan de standaarddefinitie, terwijl de juiste hoogte-breedteverhouding behouden blijft. Het formaat wordt alleen aangepast als de video een hogere resolutie heeft. Een invoer van 1920x1080 wordt bijvoorbeeld geschaald naar 640x360 voordat deze wordt verwerkt. Als u overschakelt naar StandardDefinition, vermindert u de tijd die nodig is om video met hoge resolutie te verwerken. Het kan ook de kosten voor het gebruik van dit onderdeel verlagen (zie https://azure.microsoft.com/pricing/details/media-services/#analytics voor meer informatie). Gezichten die uiteindelijk te klein zijn in de aangepaste video, kunnen echter niet worden gedetecteerd. Toegestane waarden: StandardDefinition, SourceResolution.

--video-analysis-mode

Bepaalt de set audioanalysebewerkingen die moeten worden uitgevoerd. Indien niet opgegeven, wordt de Standaard AudioAnalysisMode gekozen. Toegestane waarden: Standard, Basic.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az ams transform delete

Bewerken

Een transformatie verwijderen.

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

Optionele parameters

--account-name -a

De naam van het Azure Media Services-account.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de transformatie.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az ams transform list

Bewerken

Alle transformaties van een Azure Media Services-account weergeven.

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

Vereiste parameters

--account-name -a

De naam van het Azure Media Services-account.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--filter

Hiermee beperkt u de set geretourneerde items.

--orderby

Hiermee geeft u de sleutel op waarmee de resultaatverzameling moet worden geordend.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az ams transform show

Bewerken

De details van een transformatie weergeven.

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

Optionele parameters

--account-name -a

De naam van het Azure Media Services-account.

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de transformatie.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az ams transform update

Bewerken

Werk de details van een transformatie bij.

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

Voorbeelden

Werk de eerste transformatieuitvoer van een transformatie bij door de relatieve prioriteit ervan in te stellen op Hoog.

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

Optionele parameters

--account-name -a

De naam van het Azure Media Services-account.

--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string or JSON string>.

Default value: []
--description

De beschrijving van de transformatie.

--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

Default value: False
--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

De naam van de transformatie.

--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OR---remove propertyToRemove.

Default value: []
--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.

Default value: []
--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.