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 gelijkwaardigeaz network private-endpoint
opdrachten. - Voer ook een upgrade
az ml workspace share
uit van opdrachten naar gelijkwaardigeaz 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
[--allow-roleassignment-on-rg]
[--application-insights]
[--container-registry]
[--default-resource-group]
[--description]
[--display-name]
[--enable-data-isolation]
[--file]
[--hub-id]
[--image-build-compute]
[--key-vault]
[--kind]
[--location]
[--managed-network]
[--name]
[--no-wait]
[--primary-user-assigned-identity]
[--public-network-access]
[--set]
[--storage-account]
[--system-datastores-auth-mode]
[--tags]
[--update-dependent-resources]
Voorbeelden
Maak een werkruimte op basis van een YAML-specificatiebestand.
az ml workspace create --file workspace.yml --resource-group my-resource-group
Vereiste parameters
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Optionele parameters
Een vlag om te bepalen of een werkruimte roltoewijzingen kan hebben op resourcegroepniveau.
ARM-id van de application insights die aan deze werkruimte zijn gekoppeld.
ARM-id van het containerregister dat is gekoppeld aan deze werkruimte.
Alleen hub-soort. Als deze optie is ingesteld, worden voor onderliggende projecten van deze hub standaard de resourcegroep ingesteld.
Beschrijving van de Azure ML-werkruimte.
Weergavenaam voor de werkruimte.
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.
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.
Alleen projecttype: een ARM-id die de bovenliggende hub van dit project definieert.
De naam van het rekendoel dat moet worden gebruikt voor het bouwen van Docker-installatiekopieën wanneer het containerregister zich achter een VNet bevindt.
ARM-id van de sleutelkluis die is gekoppeld aan deze werkruimte.
Hiermee geeft u de werkruimten op als een specifiek type, waarbij de waarde die in YAML is toegewezen, wordt overschreven als deze aanwezig is. Standaardwaarden zijn standaard ingesteld. Geldige soorten zijn: standaard, hub en project.
De locatie die moet worden gebruikt voor de nieuwe werkruimte.
Beheerde netwerkisolatiemodus voor de werkruimte.
Naam van de Azure ML-werkruimte.
Wacht niet totdat het maken van de werkruimte is voltooid.
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.
Openbare eindpuntconnectiviteit toestaan wanneer een werkruimte is ingeschakeld.
Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=.
ARM-id van het opslagaccount dat is gekoppeld aan deze werkruimte.
Hiermee geeft u de verificatiemodus voor de systeemgegevensarchieven. Geldige modi zijn: toegangssleutel en identiteit.
Door spaties gescheiden sleutel-waardeparen voor de tags van het object.
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.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>
.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Optionele parameters
Verwijder alle afhankelijke resources die zijn gekoppeld aan de werkruimte (Azure Storage-account, Azure Container Registry, Azure-toepassing Insights, Azure Key Vault).
Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.
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.
Niet vragen om bevestiging.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>
.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Optionele parameters
Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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 [--filtered-kinds]
[--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
Geef alleen de opgegeven soorten werkruimten weer als een door komma's gescheiden lijst. Geldige soorten zijn: standaard, hub en project.
Maximum aantal resultaten dat moet worden geretourneerd.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>
.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>
.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Optionele parameters
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.
Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>
.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>
.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Optionele parameters
Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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]
[--allow-roleassignment-on-rg]
[--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]
[--system-datastores-auth-mode]
[--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
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>
.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Optionele parameters
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>
.
Een vlag om te bepalen of een werkruimte roltoewijzingen kan hebben op resourcegroepniveau.
ARM-id van de application insights die aan deze werkruimte zijn gekoppeld.
ARM-id van het containerregister dat is gekoppeld aan deze werkruimte.
Beschrijving van de Azure ML-werkruimte.
Weergavenaam voor de werkruimte.
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.
Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.
De naam van het rekendoel dat moet worden gebruikt voor het bouwen van Docker-installatiekopieën wanneer het containerregister zich achter een VNet bevindt.
Beheerde netwerkisolatiemodus voor de werkruimte.
Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.
ARM-id van de primaire door de gebruiker toegewezen identiteit die is gekoppeld aan deze werkruimte.
Openbare eindpuntconnectiviteit toestaan wanneer een werkruimte is ingeschakeld.
Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove>
OF --remove propertyToRemove
.
Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>
.
Hiermee geeft u de verificatiemodus voor de systeemgegevensarchieven. Geldige modi zijn: toegangssleutel en identiteit.
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.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.