Gestire le aree di lavoro di Azure Machine Learning con Azure PowerShell

  • Articolo

Usare il modulo Azure PowerShell per Azure Machine Learning per creare e gestire le aree di lavoro di Azure Machine Learning. Per un elenco completo dei cmdlet di Azure PowerShell per Azure Machine Learning, vedere la documentazione di riferimento su Az.MachineLearningServices.

È anche possibile gestire le aree di lavoro anche usando l’interfaccia della riga di comando di Azure, il portale di Azure e l'SDK Python o l'estensione VS Code.

Prerequisiti

  • Una sottoscrizione di Azure. Se non è disponibile, provare la versione gratuita o a pagamento di Azure Machine Learning.

  • Il modulo di Azure PowerShell. Per assicurarsi di avere la versione più recente, vedere Installare il modulo Azure PowerShell.

    Importante

    Durante la fase di anteprima, è necessario installare il modulo Az.MachineLearningServices di PowerShell separatamente usando il cmdlet Install-Module.

    Install-Module -Name Az.MachineLearningServices -Scope CurrentUser -Repository PSGallery -Force

Accedere ad Azure

Accedere alla sottoscrizione di Azure con il comando Connect-AzAccount e seguire le istruzioni visualizzate.

Connect-AzAccount

Se non si sa quale posizione usare, è possibile elencare le posizioni disponibili. Per visualizzare l'elenco di posizioni e trovare quella desiderata, usare il codice di esempio seguente. Questo esempio usa eastus. Archiviare la posizione in una variabile e usare la variabile in modo da poter eseguire la modifica in un'unica posizione.

Get-AzLocation | Select-Object -Property Location
$Location = 'eastus'

Creare un gruppo di risorse

Creare un gruppo di risorse di Azure con New-AzResourceGroup. Un gruppo di risorse è un contenitore logico in cui vengono distribuite e gestite le risorse di Azure.

$ResourceGroup = 'MyResourceGroup'
New-AzResourceGroup -Name $ResourceGroup -Location $Location

Creare risorse di dipendenza

Un'area di lavoro di Azure Machine Learning dipende dalle risorse di Azure seguenti:

  • Application Insights
  • Azure Key Vault
  • Account di archiviazione di Azure

Usare i comandi seguenti per creare queste risorse e recuperare l'ID di Azure Resource Manager per ognuno di essi:

Nota

Il provider di risorse Microsoft.Insights deve essere registrato per la sottoscrizione prima di eseguire i comandi seguenti. Si tratta di una registrazione effettuata una sola volta. Usare Register-AzResourceProvider -ProviderNamespace Microsoft.Insights per eseguire la registrazione.

  1. Creare l'istanza di Application Insights:

    $AppInsights = 'MyAppInsights'
New-AzApplicationInsights -Name $AppInsights -ResourceGroupName $ResourceGroup -Location $Location
$appid = (Get-AzResource -Name $AppInsights -ResourceGroupName $ResourceGroup).ResourceId

  2. Creare Azure Key Vault:

    Importante

    Ogni insieme di credenziali delle chiavi deve avere un nome univoco. Sostituire MyKeyVault con il nome dell'insieme di credenziali delle chiavi nell'esempio seguente.

    $KeyVault = 'MyKeyVault'
New-AzKeyVault -Name $KeyVault -ResourceGroupName $ResourceGroup -Location $Location
$kvid = (Get-AzResource -Name $KeyVault -ResourceGroupName $ResourceGroup).ResourceId

  3. Creare l'account di archiviazione di Azure:

    Importante

    Ogni account di archiviazione deve avere un nome univoco. Sostituire MyStorage con il nome dell'account di archiviazione nell'esempio seguente. È possibile usare Get-AzStorageAccountNameAvailability -Name 'YourUniqueName' per verificare il nome prima di eseguire l'esempio seguente.

    $Storage = 'MyStorage'

$storageParams = @{
  Name = $Storage
  ResourceGroupName = $ResourceGroup
  Location = $Location
  SkuName = 'Standard_LRS'
  Kind = 'StorageV2'
}
New-AzStorageAccount @storageParams

$storeid = (Get-AzResource -Name $Storage -ResourceGroupName $ResourceGroup).ResourceId

Creare un'area di lavoro

Nota

Il provider di risorse Microsoft.MachineLearningServices deve essere registrato per la sottoscrizione prima di eseguire i comandi seguenti. Si tratta di una registrazione effettuata una sola volta. Usare Register-AzResourceProvider -ProviderNamespace Microsoft.MachineLearningServices per eseguire la registrazione.

Il comando seguente crea l'area di lavoro e la configura per l'uso dei servizi creati in precedenza. Inoltre il comando configura l'area di lavoro per l'uso di un'identità gestita assegnata dal sistema, usata per accedere a questi servizi. Per altre informazioni sull'uso di identità gestite con Azure Machine Learning, vedere l'articolo Configurare l'autenticazione per altri servizi.

$Workspace = 'MyWorkspace'
$mlWorkspaceParams = @{
  Name = $Workspace
  ResourceGroupName = $ResourceGroup
  Location = $Location
  ApplicationInsightID = $appid
  KeyVaultId = $kvid
  StorageAccountId = $storeid
  IdentityType = 'SystemAssigned'
}
New-AzMLWorkspace @mlWorkspaceParams

Ottenere informazioni sull’area di lavoro

Per recuperare un elenco di aree di lavoro, usare il comando seguente:

Get-AzMLWorkspace

Per recuperare informazioni su un'area di lavoro specifica, specificare le informazioni sul nome e sul gruppo di risorse:

Get-AzMLWorkspace -Name $Workspace -ResourceGroupName $ResourceGroup

Eliminazione di un'area di lavoro

Avviso

Se l'eliminazione temporanea è abilitata per l'area di lavoro, può essere ripristinata dopo l'eliminazione. Se l'eliminazione temporanea non è abilitata o si seleziona l'opzione per eliminare definitivamente l'area di lavoro, non è possibile recuperarla. Per altre informazioni, vedere Ripristinare un'area di lavoro eliminata.

Per eliminare un'area di lavoro dopo che non è più necessaria, usare il comando seguente:

Remove-AzMLWorkspace -Name $Workspace -ResourceGroupName $ResourceGroup

Importante

L'eliminazione di un'area di lavoro non comporta l'eliminazione di Application Insights, dell'account di archiviazione, dell'insieme di credenziali delle chiavi o del registro contenitori usati dall'area di lavoro.

È anche possibile eliminare il gruppo di risorse che comporta l’eliminazione dell’area di lavoro e di tutte le altre risorse di Azure contenute al suo interno. Per eliminare il gruppo di risorse, usare il comando seguente:

Remove-AzResourceGroup -Name $ResourceGroup

Passaggi successivi

Per verificare la presenza di problemi con l'area di lavoro, vedere Come usare la diagnostica dell'area di lavoro.

Per informazioni su come spostare un'area di lavoro in una nuova sottoscrizione di Azure, vedere Come spostare un'area di lavoro.

Per informazioni su come mantenere aggiornato Azure Machine Learning con gli aggiornamenti della sicurezza più recenti, vedere Gestione delle vulnerabilità.

Per informazioni su come eseguire il training di un modello di Machine Learning con l'area di lavoro, vedere l'esercitazione Azure Machine Learning in un giorno.