Gerenciar espaços de trabalho do Azure Machine Learning usando o Azure PowerShell

Use o módulo do Azure PowerShell para Azure Machine Learning para criar e gerenciar seus espaços de trabalho do Azure Machine Learning. Para obter uma lista completa dos cmdlets do Azure PowerShell para o Azure Machine Learning, consulte a documentação de referência do Az.MachineLearningServices .

Você também pode gerenciar espaços de trabalho usando a CLI do Azure, o portal do Azure e o SDK do Python ou por meio da extensão VS Code.

Pré-requisitos

  • Uma subscrição do Azure. Se não tiver uma, experimente a versão gratuita ou paga do Azure Machine Learning.

  • O módulo do Azure PowerShell. Para se certificar de que tem a versão mais recente, consulte Instalar o módulo do Azure PowerShell.

    Importante

    Enquanto o módulo Az.MachineLearningServices PowerShell estiver em visualização, você deve instalá-lo separadamente usando o Install-Module cmdlet.

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

Iniciar sessão no Azure

Inicie sessão na sua subscrição do Azure com o comando Connect-AzAccount e siga as instruções no ecrã.

Connect-AzAccount

Se não souber qual a localização que quer utilizar, pode listar as localizações disponíveis. Apresente a lista de localizações com o seguinte exemplo de código e encontre o que pretende utilizar. Este exemplo utiliza eastus. Armazene a localização numa variável e utilize-a de forma a poder alterá-la num único local.

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

Criar um grupo de recursos

Crie um grupo de recursos do Azure com New-AzResourceGroup. Um grupo de recursos é um contentor lógico no qual os recursos do Azure são implementados e geridos.

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

Criar recursos de dependência

Um espaço de trabalho do Azure Machine Learning depende dos seguintes recursos do Azure:

  • Application Insights
  • Azure Key Vault
  • Conta de armazenamento do Azure

Use os seguintes comandos para criar esses recursos e recuperar a ID do Azure Resource Manager para cada um deles:

Nota

O provedor de recursos do Microsoft.Insights deve estar registrado para sua assinatura antes de executar os comandos a seguir. Este é um registo único. Use Register-AzResourceProvider -ProviderNamespace Microsoft.Insights para realizar o registro.

  1. Crie a instância do Application Insights:

    $AppInsights = 'MyAppInsights'
    New-AzApplicationInsights -Name $AppInsights -ResourceGroupName $ResourceGroup -Location $Location
    $appid = (Get-AzResource -Name $AppInsights -ResourceGroupName $ResourceGroup).ResourceId
    
    
  2. Crie o Cofre da Chave do Azure:

    Importante

    Cada cofre de chaves deve ter um nome exclusivo. Substitua MyKeyVault pelo nome do cofre de chaves no exemplo a seguir.

    $KeyVault = 'MyKeyVault'
    New-AzKeyVault -Name $KeyVault -ResourceGroupName $ResourceGroup -Location $Location
    $kvid = (Get-AzResource -Name $KeyVault -ResourceGroupName $ResourceGroup).ResourceId
    
    
  3. Crie a Conta de Armazenamento do Azure:

    Importante

    Cada conta de armazenamento tem de ter um nome exclusivo. Substitua MyStorage pelo nome da sua conta de armazenamento no exemplo a seguir. Você pode usar Get-AzStorageAccountNameAvailability -Name 'YourUniqueName' para verificar o nome antes de executar o exemplo a seguir.

    $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
    
    

Criar uma área de trabalho

Nota

O provedor de recursos Microsoft.MachineLearningServices deve estar registrado para sua assinatura antes de executar os comandos a seguir. Este é um registo único. Use Register-AzResourceProvider -ProviderNamespace Microsoft.MachineLearningServices para realizar o registro.

O comando a seguir cria o espaço de trabalho e o configura para usar os serviços criados anteriormente. Ele também configura o espaço de trabalho para usar uma identidade gerenciada atribuída ao sistema, que é usada para acessar esses serviços. Para obter mais informações sobre como usar identidades gerenciadas com o Azure Machine Learning, consulte o artigo Configurar autenticação para outros serviços .

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

Obter informações sobre o espaço de trabalho

Para recuperar uma lista de espaços de trabalho, use o seguinte comando:

Get-AzMLWorkspace

Para recuperar informações em um espaço de trabalho específico, forneça o nome e as informações do grupo de recursos:

Get-AzMLWorkspace -Name $Workspace -ResourceGroupName $ResourceGroup

Eliminar uma área de trabalho

Aviso

Se a exclusão suave estiver habilitada para o espaço de trabalho, ela poderá ser recuperada após a exclusão. Se a exclusão suave não estiver habilitada ou se você selecionar a opção para excluir permanentemente o espaço de trabalho, ele não poderá ser recuperado. Para obter mais informações, consulte Recuperar um espaço de trabalho excluído.

Para excluir um espaço de trabalho depois que ele não for mais necessário, use o seguinte comando:

Remove-AzMLWorkspace -Name $Workspace -ResourceGroupName $ResourceGroup

Importante

A exclusão de um espaço de trabalho não exclui o insight do aplicativo, a conta de armazenamento, o cofre de chaves ou o registro de contêiner usados pelo espaço de trabalho.

Você também pode excluir o grupo de recursos, que exclui o espaço de trabalho e todos os outros recursos do Azure no grupo de recursos. Para excluir o grupo de recursos, use o seguinte comando:

Remove-AzResourceGroup -Name $ResourceGroup

Próximos passos

Para verificar se há problemas com seu espaço de trabalho, consulte Como usar o diagnóstico do espaço de trabalho.

Para saber como mover um espaço de trabalho para uma nova assinatura do Azure, consulte Como mover um espaço de trabalho.

Para obter informações sobre como manter seu Aprendizado de Máquina do Azure atualizado com as atualizações de segurança mais recentes, consulte Gerenciamento de vulnerabilidades.

Para saber como treinar um modelo de ML com seu espaço de trabalho, consulte o tutorial do Azure Machine Learning em um dia .