Gerir áreas de trabalho do Azure Machine Learning com Azure PowerShell

Artigo
09/13/2023

Utilize o módulo Azure PowerShell do Azure Machine Learning para criar e gerir as suas áreas de trabalho do Azure Machine Learning. Para obter uma lista completa dos cmdlets Azure PowerShell do Azure Machine Learning, veja a documentação de referência Az.MachineLearningServices.

Também pode gerir áreas de trabalho com a CLI do Azure, portal do Azure e o SDK Python ou através da extensão do 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 Azure PowerShell. Para se certificar de que tem a versão mais recente, consulte Instalar o módulo Azure PowerShell.

Importante

Enquanto o módulo Az.MachineLearningServices powerShell está em pré-visualização, tem de instalá-lo separadamente com o Install-Module cmdlet.
```
Install-Module -Name Az.MachineLearningServices -Scope CurrentUser -Repository PSGallery -Force
```

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

Uma área de trabalho do Azure Machine Learning depende dos seguintes recursos do Azure:

Application Insights
Azure Key Vault
Conta de Armazenamento do Azure

Utilize os seguintes comandos para criar estes recursos e obter o ID de Resource Manager do Azure para cada um deles:

Nota

O fornecedor de recursos Microsoft.Insights tem de estar registado na sua subscrição antes de executar os seguintes comandos. Este é um registo único. Utilize Register-AzResourceProvider -ProviderNamespace Microsoft.Insights para efetuar o registo.

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

Crie o Key Vault do Azure:

Importante

Cada cofre de chaves tem de ter um nome exclusivo. Substitua MyKeyVault pelo nome do cofre de chaves no exemplo seguinte.

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

Criar 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 seguinte. Pode utilizar Get-AzStorageAccountNameAvailability -Name 'YourUniqueName' para verificar o nome antes de executar o exemplo seguinte.
```
$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 fornecedor de recursos Microsoft.MachineLearningServices tem de estar registado na sua subscrição antes de executar os seguintes comandos. Este é um registo único. Utilize Register-AzResourceProvider -ProviderNamespace Microsoft.MachineLearningServices para efetuar o registo.

O comando seguinte cria a área de trabalho e configura-a para utilizar os serviços criados anteriormente. Também configura a área de trabalho para utilizar uma identidade gerida atribuída pelo sistema, que é utilizada para aceder a estes serviços. Para obter mais informações sobre como utilizar identidades geridas com o Azure Machine Learning, veja o artigo Configurar a 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 da área de trabalho

Para obter uma lista de áreas de trabalho, utilize o seguinte comando:

Get-AzMLWorkspace

Para obter informações sobre uma área de trabalho específica, 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 eliminação recuperável estiver ativada para a área de trabalho, pode ser recuperada após a eliminação. Se a eliminação recuperável não estiver ativada ou se selecionar a opção para eliminar permanentemente a área de trabalho, não poderá recuperá-la. Para obter mais informações, veja Recuperar uma área de trabalho eliminada.

Para eliminar uma área de trabalho depois de já não ser necessária, utilize o seguinte comando:

Remove-AzMLWorkspace -Name $Workspace -ResourceGroupName $ResourceGroup

Importante

Eliminar uma área de trabalho não elimina as informações da aplicação, a conta de armazenamento, o cofre de chaves ou o registo de contentor utilizado pela área de trabalho.

Também pode eliminar o grupo de recursos, que elimina a área de trabalho e todos os outros recursos do Azure no grupo de recursos. Para eliminar o grupo de recursos, utilize o seguinte comando:

Remove-AzResourceGroup -Name $ResourceGroup

Passos seguintes

Para verificar se existem problemas com a área de trabalho, veja Como utilizar os diagnósticos da área de trabalho.

Para saber como mover uma área de trabalho para uma nova subscrição do Azure, veja Como mover uma área de trabalho.

Para obter informações sobre como manter o Azure Machine Learning atualizado com as atualizações de segurança mais recentes, veja Gestão de vulnerabilidades.

Para saber como preparar um modelo de ML com a sua área de trabalho, veja o tutorial do Azure Machine Learning num dia .