az ml component

Note

This reference is part of the ml extension for the Azure CLI (version 2.15.0 or higher). De extensie installeert automatisch de eerste keer dat u een az ml component opdracht uitvoert. Learn more about extensions.

Azure ML-onderdelen beheren.

Het Azure ML-onderdeel definieert de configuratie van het onderdeel voor pijplijntaken. U kunt de invoer-/uitvoerpoorten, de uitvoeringsomgeving en de opdracht van het onderdeel configureren. Nadat het onderdeel is gemaakt, kunt u verwijzen naar de onderdelen in de pijplijntaak om ze uit te voeren in docker-containers.

Opdracht

Name	Description	Type	Status
az ml component archive	Een onderdeel archiveren.	Extension	GA
az ml component create	Maak een onderdeel.	Extension	GA
az ml component list	Onderdelen in een werkruimte weergeven.	Extension	GA
az ml component prepare-for-sign	Bereid een onderdeel voor op ondertekening.	Extension	GA
az ml component restore	Een gearchiveerd onderdeel herstellen.	Extension	GA
az ml component show	Details voor een onderdeel weergeven.	Extension	GA
az ml component update	Een onderdeel bijwerken. Momenteel ondersteunen slechts enkele velden (beschrijving, display_name) update.	Extension	GA

az ml component archive

Een onderdeel archiveren.

Als u een onderdeel archivert, wordt dit standaard verborgen in lijstquery's (az ml component list). U kunt nog steeds verwijzen naar en een gearchiveerd onderdeel in uw pijplijnen gebruiken. U kunt een onderdeelcontainer of een specifieke onderdeelversie archiveren. Als u een onderdeelcontainer archivert, worden alle versies van het onderdeel onder die naam gearchiveerd. U kunt een gearchiveerd onderdeel herstellen met behulp van az ml component restore. Als de hele onderdeelcontainer is gearchiveerd, kunt u geen afzonderlijke versies van het onderdeel herstellen. U moet de onderdeelcontainer herstellen.

az ml component archive --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Voorbeelden

Een onderdeelcontainer archiveren (alle versies van dat onderdeel archiveren)

az ml component archive --name my-component --resource-group my-resource-group --workspace-name my-workspace

Een specifieke onderdeelversie archiveren

az ml component archive --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Vereiste parameters

--name -n

Naam van het onderdeel.

Optionele parameters

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

--label -l

Label van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

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

--version -v

Versie van het onderdeel.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

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

Eigenschap	Waarde
Default value:	False

az ml component create

Maak een onderdeel.

az ml component create --file
                       [--name]
                       [--registry-name]
                       [--resource-group]
                       [--set]
                       [--skip-validation]
                       [--version]
                       [--workspace-name]

Voorbeelden

Een onderdeel maken op basis van een YAML-specificatiebestand

az ml component create --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

Een onderdeel maken op basis van een YAML-specificatiebestand met de opgegeven versie

az ml component create --file my_component.yml --version 1 --resource-group my-resource-group --workspace-name my-workspace

Een onderdeel in het register maken op basis van een YAML-specificatiebestand

az ml component create --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group

Een onderdeel in het register maken op basis van een YAML-specificatiebestand met de opgegeven versie

az ml component create --file my_component.yml --version 1 --registry-name my-registry-name --resource-group my-resource-group

Vereiste parameters

--file -f

Lokaal pad naar het YAML-bestand met de specificatie van het Azure ML-onderdeel. De YAML-referentiedocumenten voor het onderdeel vindt u op: https://aka.ms/ml-cli-v2-component-command-yaml-reference.

Optionele parameters

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

--name -n

Naam van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

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

--skip-validation

Validatie overslaan bij het maken van de resource. Houd er rekening mee dat afhankelijke resources hun validatie bij het maken niet overslaan.

Eigenschap	Waarde
Default value:	False

--version -v

Versie van het onderdeel.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

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

Eigenschap	Waarde
Default value:	False

az ml component list

Onderdelen in een werkruimte weergeven.

az ml component list [--archived-only]
                     [--include-archived]
                     [--max-results]
                     [--name]
                     [--registry-name]
                     [--resource-group]
                     [--workspace-name]

Voorbeelden

Alle onderdelen in een werkruimte weergeven

az ml component list --resource-group my-resource-group --workspace-name my-workspace

Alle onderdeelversies voor de opgegeven naam in een werkruimte weergeven

az ml component list --name my-component --resource-group my-resource-group --workspace-name my-workspace

Geef alle onderdelen in een werkruimte weer met behulp van het argument --query om een JMESPath-query uit te voeren op de resultaten van opdrachten.

az ml component list --query "[].{Name:name}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Alle onderdelen in een register weergeven

az ml component list --registry-name my-registry-name --resource-group my-resource-group

Alle onderdeelversies voor de opgegeven naam in een register weergeven

az ml component list --name my-component --registry-name my-registry-name --resource-group my-resource-group

Geef alle onderdelen in een register weer met behulp van het argument --query om een JMESPath-query uit te voeren op de resultaten van opdrachten.

az ml component list --query "[].{Name:name}"  --output table --registry-name my-registry-name --resource-group my-resource-group

Optionele parameters

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

--archived-only

Alleen gearchiveerde onderdelen weergeven.

Eigenschap	Waarde
Default value:	False

--include-archived

Gearchiveerde onderdelen en actieve onderdelen weergeven.

Eigenschap	Waarde
Default value:	False

--max-results -r

Maximum aantal resultaten dat moet worden geretourneerd.

--name -n

Naam van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

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

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

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

Eigenschap	Waarde
Default value:	False

az ml component prepare-for-sign

Bereid een onderdeel voor op ondertekening.

Het voorbereiden van een onderdeel voor teken genereert 2 bestanden: catalog.json en catalog.json.sig, deze bestanden bevatten de SHA256 die is gegenereerd voor elk bestand dat aanwezig is in de doelmap. Als de bestanden al aanwezig zijn, worden ze verwijderd en worden nieuwe bestanden gemaakt met bijgewerkte handtekening.

az ml component prepare-for-sign --file
                                 [--registry-name]
                                 [--resource-group]
                                 [--workspace-name]

Voorbeelden

Een onderdeel voorbereiden op basis van een YAML-specificatiebestand voor ondertekening

az ml component prepare-for-sign --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

Een onderdeel in het register voorbereiden vanuit een YAML-specificatiebestand voor ondertekening

az ml component prepare-for-sign --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group

Vereiste parameters

--file -f

Lokaal pad naar het YAML-bestand met de specificatie van het Azure ML-onderdeel. De YAML-referentiedocumenten voor het onderdeel vindt u op: https://aka.ms/ml-cli-v2-component-command-yaml-reference.

Optionele parameters

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

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

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

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

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

Eigenschap	Waarde
Default value:	False

az ml component restore

Een gearchiveerd onderdeel herstellen.

Wanneer een gearchiveerd onderdeel wordt hersteld, wordt het niet meer verborgen voor lijstquery's (az ml component list). Als een hele onderdeelcontainer is gearchiveerd, kunt u die gearchiveerde container herstellen. Hiermee worden alle versies van het onderdeel onder die naam hersteld. U kunt alleen een specifieke onderdeelversie herstellen als de hele onderdeelcontainer is gearchiveerd. U moet de hele container herstellen. Als alleen een afzonderlijke onderdeelversie is gearchiveerd, kunt u die specifieke versie herstellen.

az ml component restore --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Voorbeelden

Een gearchiveerde onderdeelcontainer herstellen (herstelt alle versies van dat onderdeel)

az ml component restore --name my-component --resource-group my-resource-group --workspace-name my-workspace

Een specifieke gearchiveerde onderdeelversie herstellen

az ml component restore --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Vereiste parameters

--name -n

Naam van het onderdeel.

Optionele parameters

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

--label -l

Label van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

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

--version -v

Versie van het onderdeel.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

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

Eigenschap	Waarde
Default value:	False

az ml component show

Details voor een onderdeel weergeven.

az ml component show --name
                     [--label]
                     [--registry-name]
                     [--resource-group]
                     [--version]
                     [--workspace-name]

Voorbeelden

Details weergeven voor een onderdeel met de opgegeven naam en versie

az ml component show --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Details weergeven voor een onderdeel in het register met de opgegeven naam en versie

az ml component show --name my-component --version 1 --registry-name my-registry-name --resource-group my-resource-group

Vereiste parameters

--name -n

Naam van het onderdeel.

Optionele parameters

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

--label -l

Label van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

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

--version -v

Versie van het onderdeel.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

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

Eigenschap	Waarde
Default value:	False

az ml component update

Een onderdeel bijwerken. Momenteel ondersteunen slechts enkele velden (beschrijving, display_name) update.

az ml component update --name
                       --resource-group
                       --workspace-name
                       [--add]
                       [--force-string]
                       [--label]
                       [--registry-name]
                       [--remove]
                       [--set]
                       [--version]

Voorbeelden

De beschrijving van een onderdeel bijwerken

az ml component update -n my_component -v 1 --set description="new description" -g my-resource-group -w my-workspace

Vereiste parameters

--name -n

Naam van het onderdeel.

--resource-group -g

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

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Optionele parameters

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

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

Eigenschap	Waarde
Parameter group:	Generic Update Arguments
Default value:	[]

--force-string

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

Eigenschap	Waarde
Parameter group:	Generic Update Arguments
Default value:	False

--label -l

Label van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--remove

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

Eigenschap	Waarde
Parameter group:	Generic Update Arguments
Default value:	[]

--set

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

Eigenschap	Waarde
Parameter group:	Generic Update Arguments
Default value:	[]

--version -v

Versie van het onderdeel.

Globale parameters

--debug

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

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Output format.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

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

Eigenschap	Waarde
Default value:	False

Delen via

az ml component

Opdracht

az ml component archive

Voorbeelden

Vereiste parameters

Optionele parameters

az ml component create

Voorbeelden

Vereiste parameters

Optionele parameters

az ml component list

Voorbeelden

Optionele parameters

az ml component prepare-for-sign

Voorbeelden

Vereiste parameters

Optionele parameters

az ml component restore

Voorbeelden

Vereiste parameters

Optionele parameters

az ml component show

Voorbeelden

Vereiste parameters

Optionele parameters

az ml component update

Voorbeelden

Vereiste parameters

Optionele parameters

Feedback