az ml workspace

Notitie

Deze verwijzing maakt deel uit van de ml-extensie voor de Azure CLI (versie 2.15.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az ml-werkruimteopdracht uitvoert. Meer informatie over extensies.

Azure ML-werkruimten beheren.

Een Azure ML-werkruimte is de resource op het hoogste niveau voor Azure Machine Learning. Het biedt een centrale locatie voor het bijhouden van de assets en resources die worden gebruikt in uw ML-werkstromen, samen met de logboeken en artefacten die zijn geproduceerd uit uw trainingstaken.

Als u een upgrade uitvoert van CLI v1 naar v2, hebt u de volgende twee wijzigingen in het bereik van werkruimtebeheer nodig:

• Upgrade-opdrachten az ml workspace private-endpoint naar gelijkwaardige az network private-endpoint opdrachten.
• Voer ook een upgrade az ml workspace share uit van opdrachten naar gelijkwaardige az role assignment create opdrachten.

Opdracht

Name	Description	Type	Status
az ml workspace create	Een werkruimte maken.	Toestel	GA
az ml workspace delete	Een werkruimte verwijderen.	Toestel	GA
az ml workspace diagnose	Problemen met het instellen van werkruimten vaststellen.	Toestel	GA
az ml workspace list	Geef alle werkruimten in een abonnement weer.	Toestel	GA
az ml workspace list-keys	Geef werkruimtesleutels weer voor afhankelijke resources, zoals Azure Storage, Azure Container Registry en Azure-toepassing Insights.	Toestel	GA
az ml workspace outbound-rule	Regels voor uitgaand verkeer beheren voor het beheerde netwerk van een Azure ML-werkruimte.	Toestel	GA
az ml workspace outbound-rule list	Geef alle uitgaande regels voor het beheerde netwerk voor een werkruimte weer.	Toestel	GA
az ml workspace outbound-rule remove	Verwijder een uitgaande regel uit het beheerde netwerk voor een werkruimte.	Toestel	GA
az ml workspace outbound-rule set	Een uitgaande regel toevoegen of bijwerken in het beheerde netwerk voor een werkruimte.	Toestel	GA
az ml workspace outbound-rule show	Details weergeven voor een uitgaande regel voor een beheerd netwerk voor een werkruimte.	Toestel	GA
az ml workspace provision-network	Het beheerde netwerk van de werkruimte inrichten.	Toestel	GA
az ml workspace show	Details weergeven voor een werkruimte.	Toestel	GA
az ml workspace sync-keys	Synchroniseer werkruimtesleutels voor afhankelijke resources, zoals Azure Storage, Azure Container Registry en Azure-toepassing Insights.	Toestel	GA
az ml workspace update	Een werkruimte bijwerken.	Toestel	GA

az ml workspace create

Een werkruimte maken.

Wanneer een werkruimte wordt gemaakt, worden verschillende Azure-resources die door Azure ML worden gebruikt, ook standaard gemaakt: Azure Storage, Azure Container Registry, Azure Key Vault en Azure-toepassing Insights. U kunt in plaats daarvan bestaande Azure-resource-exemplaren gebruiken voor exemplaren bij het maken van de werkruimte door de resource-id's op te geven in het YAML-bestand voor de werkruimteconfiguratie.

az ml workspace create --resource-group
                       [--application-insights]
                       [--container-registry]
                       [--description]
                       [--display-name]
                       [--enable-data-isolation]
                       [--file]
                       [--image-build-compute]
                       [--key-vault]
                       [--location]
                       [--managed-network]
                       [--name]
                       [--no-wait]
                       [--primary-user-assigned-identity]
                       [--public-network-access]
                       [--set]
                       [--storage-account]
                       [--tags]
                       [--update-dependent-resources]
                       [--workspace-hub]

Voorbeelden

Maak een werkruimte op basis van een YAML-specificatiebestand.

az ml workspace create --file workspace.yml --resource-group my-resource-group

Vereiste parameters

--resource-group -g

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

Optionele parameters

--application-insights -a

ARM-id van de application insights die aan deze werkruimte zijn gekoppeld.

--container-registry -c

ARM-id van het containerregister dat is gekoppeld aan deze werkruimte.

--description

Beschrijving van de Azure ML-werkruimte.

--display-name

Weergavenaam voor de werkruimte.

--enable-data-isolation -e

Een vlag om te bepalen of voor een werkruimte gegevensisolatie is ingeschakeld. De vlag kan alleen worden ingesteld tijdens de aanmaakfase. Deze kan niet worden bijgewerkt.

standaardwaarde: False

--file -f

Lokaal pad naar het YAML-bestand met de Azure ML-werkruimtespecificatie. De YAML-referentiedocumenten voor werkruimte vindt u op: https://aka.ms/ml-cli-v2-workspace-yaml-reference.

--image-build-compute -i

De naam van het rekendoel dat moet worden gebruikt voor het bouwen van Docker-installatiekopieën wanneer het containerregister zich achter een VNet bevindt.

--key-vault -k

ARM-id van de sleutelkluis die is gekoppeld aan deze werkruimte.

--location -l

De locatie die moet worden gebruikt voor de nieuwe werkruimte.

--managed-network -m

Preview

Beheerde netwerkisolatiemodus voor de werkruimte.

--name -n

Naam van de Azure ML-werkruimte.

--no-wait

Wacht niet totdat het maken van de werkruimte is voltooid.

standaardwaarde: False

--primary-user-assigned-identity -p

ARM-id van de door de primaire gebruiker toegewezen beheerde identiteit, voor het geval er meerdere worden opgegeven. Ook de standaard beheerde identiteit voor clusterloze berekeningen.

--public-network-access

Openbare eindpuntconnectiviteit toestaan wanneer een werkruimte is ingeschakeld.

--set

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

--storage-account -s

ARM-id van het opslagaccount dat is gekoppeld aan deze werkruimte.

--tags

Door spaties gescheiden sleutel-waardeparen voor de tags van het object.

--update-dependent-resources -u

Als u --update_dependent_resources opgeeft, geeft u toestemming om de afhankelijke resources van de werkruimte bij te werken. Het bijwerken van de aan de werkruimte gekoppelde Azure Container Registry- of Application Insights-resource kan de herkomst van eerdere taken verbreken, geïmplementeerde deductie-eindpunten of de mogelijkheid om eerdere taken in deze werkruimte opnieuw uit te voeren.

standaardwaarde: False

--workspace-hub

Preview

Een ARM-id die is opgegeven voor het maken van een werkruimte, de werkruimte wordt een projectwerkruimte en alle afhankelijke resources worden gebruikt vanuit WorkspaceHub.

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

standaardwaarde: json

--query

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

--subscription

Naam of id van het 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 ml workspace delete

Een werkruimte verwijderen.

Standaard worden de afhankelijke resources die zijn gekoppeld aan de werkruimte (Azure Storage, Azure Container Registry, Azure Key Vault, Azure-toepassing Insights) niet verwijderd. Als u deze ook wilt verwijderen, neemt u --all-resources op. Als u de werkruimte definitief wilt verwijderen, moet u --permanent verwijderen.

az ml workspace delete --name
                       --resource-group
                       [--all-resources]
                       [--no-wait]
                       [--permanently-delete]
                       [--yes]

Vereiste parameters

--name -n

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

--resource-group -g

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

Optionele parameters

--all-resources

Verwijder alle afhankelijke resources die zijn gekoppeld aan de werkruimte (Azure Storage-account, Azure Container Registry, Azure-toepassing Insights, Azure Key Vault).

standaardwaarde: False

--no-wait

Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.

standaardwaarde: False

--permanently-delete -p

Werkruimten zijn standaard voorlopig verwijderd om herstel van werkruimtegegevens toe te staan. Stel deze vlag in om het gedrag voor voorlopig verwijderen te overschrijven en uw werkruimte definitief te verwijderen.

standaardwaarde: False

--yes -y

Niet vragen om bevestiging.

standaardwaarde: False

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

standaardwaarde: json

--query

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

--subscription

Naam of id van het 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 ml workspace diagnose

Problemen met het instellen van werkruimten vaststellen.

Als uw werkruimte niet werkt zoals verwacht, kunt u deze diagnose uitvoeren om te controleren of de werkruimte is verbroken. Voor een privé-eindpuntwerkruimte kunt u ook controleren of de netwerkconfiguratie voor deze werkruimte en de afhankelijke resource een probleem heeft of niet.

az ml workspace diagnose --name
                         --resource-group
                         [--no-wait]

Voorbeelden

Een werkruimte diagnosticeren.

az ml workspace diagnose --name my-workspace-name --no-wait -g my-resource-group

Vereiste parameters

--name -n

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

--resource-group -g

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

Optionele parameters

--no-wait

Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.

standaardwaarde: False

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

standaardwaarde: json

--query

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

--subscription

Naam of id van het 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 ml workspace list

Geef alle werkruimten in een abonnement weer.

De lijst met werkruimten kan worden gefilterd op resourcegroep.

az ml workspace list [--max-results]
                     [--resource-group]

Voorbeelden

Alle werkruimten in een resourcegroep weergeven

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

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

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

Optionele parameters

--max-results -r

Maximum aantal resultaten dat moet worden geretourneerd.

--resource-group -g

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

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

standaardwaarde: json

--query

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

--subscription

Naam of id van het 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 ml workspace list-keys

Geef werkruimtesleutels weer voor afhankelijke resources, zoals Azure Storage, Azure Container Registry en Azure-toepassing Insights.

az ml workspace list-keys --name
                          --resource-group

Vereiste parameters

--name -n

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

--resource-group -g

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

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

standaardwaarde: json

--query

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

--subscription

Naam of id van het 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 ml workspace provision-network

Het beheerde netwerk van de werkruimte inrichten.

Hiermee wordt de werkruimte geactiveerd om het beheerde netwerk in te richten. Als u een vlag met Spark opgeeft, wordt het beheerde netwerk van de werkruimte voorbereid voor de ondersteuning van Spark. De standaardwaarde is onwaar als deze niet is opgegeven, maar later kan worden ingeschakeld door deze opdracht opnieuw uit te voeren met deze vlag. Als deze optie is ingeschakeld, kan deze niet worden uitgeschakeld.

az ml workspace provision-network --name
                                  --resource-group
                                  [--include-spark]
                                  [--no-wait]

Voorbeelden

beheerd netwerk inrichten.

az ml workspace provision-network --include-spark --name my-workspace-name --no-wait -g my-resource-group

Vereiste parameters

--name -n

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

--resource-group -g

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

Optionele parameters

--include-spark

Booleaanse waarde [true/false] voor als het beheerde netwerk moet worden ingericht voor spark-taken. De standaardwaarde is onwaar als de vlag niet is ingesteld. Deze kan later worden ingeschakeld door deze opdracht opnieuw uit te voeren met deze vlag.

standaardwaarde: False

--no-wait

Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.

standaardwaarde: False

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

standaardwaarde: json

--query

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

--subscription

Naam of id van het 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 ml workspace show

Details weergeven voor een werkruimte.

az ml workspace show --name
                     --resource-group

Vereiste parameters

--name -n

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

--resource-group -g

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

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

standaardwaarde: json

--query

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

--subscription

Naam of id van het 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 ml workspace sync-keys

Synchroniseer werkruimtesleutels voor afhankelijke resources, zoals Azure Storage, Azure Container Registry en Azure-toepassing Insights.

Als de sleutels voor een resource in de werkruimte worden gewijzigd, kan het ongeveer een uur duren voordat ze automatisch worden bijgewerkt. Met deze opdracht wordt de werkruimte geactiveerd om sleutels onmiddellijk te synchroniseren. Een mogelijk scenario heeft onmiddellijke toegang tot opslag nodig na het opnieuw genereren van de opslagsleutels.

az ml workspace sync-keys --name
                          --resource-group
                          [--no-wait]

Vereiste parameters

--name -n

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

--resource-group -g

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

Optionele parameters

--no-wait

Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.

standaardwaarde: False

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

standaardwaarde: json

--query

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

--subscription

Naam of id van het 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 ml workspace update

Een werkruimte bijwerken.

De eigenschappen 'description', 'tags' en 'friendly_name' kunnen worden bijgewerkt.

az ml workspace update --name
                       --resource-group
                       [--add]
                       [--application-insights]
                       [--container-registry]
                       [--description]
                       [--display-name]
                       [--file]
                       [--force-string]
                       [--image-build-compute]
                       [--managed-network]
                       [--no-wait]
                       [--primary-user-assigned-identity]
                       [--public-network-access]
                       [--remove]
                       [--set]
                       [--update-dependent-resources]

Voorbeelden

een werkruimte bijwerken vanuit een YAML-specificatiebestand.

az ml workspace update --resource-group my-resource-group --name my-workspace-name --file workspace.yml

Vereiste parameters

--name -n

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

--resource-group -g

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

Optionele parameters

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

standaardwaarde: []

--application-insights -a

ARM-id van de application insights die aan deze werkruimte zijn gekoppeld.

--container-registry -c

ARM-id van het containerregister dat is gekoppeld aan deze werkruimte.

--description

Beschrijving van de Azure ML-werkruimte.

--display-name

Weergavenaam voor de werkruimte.

--file -f

Lokaal pad naar het YAML-bestand met de Azure ML-werkruimtespecificatie. De YAML-referentiedocumenten voor werkruimte vindt u op: https://aka.ms/ml-cli-v2-workspace-yaml-reference.

--force-string

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

standaardwaarde: False

--image-build-compute -i

De naam van het rekendoel dat moet worden gebruikt voor het bouwen van Docker-installatiekopieën wanneer het containerregister zich achter een VNet bevindt.

--managed-network -m

Preview

Beheerde netwerkisolatiemodus voor de werkruimte.

--no-wait

Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.

standaardwaarde: False

--primary-user-assigned-identity -p

ARM-id van de primaire door de gebruiker toegewezen identiteit die is gekoppeld aan deze werkruimte.

--public-network-access

Openbare eindpuntconnectiviteit toestaan wanneer een werkruimte is ingeschakeld.

--remove

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

standaardwaarde: []

--set

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

standaardwaarde: []

--update-dependent-resources -u

Als u --update_dependent_resources opgeeft, geeft u toestemming om de afhankelijke resources van de werkruimte bij te werken. Het bijwerken van de aan de werkruimte gekoppelde Azure Container Registry- of Application Insights-resource kan de herkomst van eerdere taken verbreken, geïmplementeerde deductie-eindpunten of de mogelijkheid om eerdere taken in deze werkruimte opnieuw uit te voeren.

standaardwaarde: False

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

standaardwaarde: json

--query

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

--subscription

Naam of id van het 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.