你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure PowerShell 管理 Azure 机器学习工作区

使用适用于 Azure 机器学习的 Azure PowerShell 模块来创建和管理 Azure 机器学习工作区。 有关 Azure 机器学习的 Azure PowerShell cmdlet 的完整列表，请参阅 Az.MachineLearningServices 参考文档。

还可以使用 Azure CLI、Azure 门户和 Python SDK 或通过 VS Code 扩展管理工作区。

先决条件

• 一个 Azure 订阅。 如果没有订阅，可试用 Azure 机器学习免费版或付费版。

• Azure PowerShell 模块。 若要确保拥有最新版本，请参阅安装 Azure PowerShell 模块。

  重要

  尽管 Az.MachineLearningServices PowerShell 模块为预览版，但必须使用 Install-Module cmdlet 单独安装它。

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

登录 Azure

运行 Connect-AzAccount 命令以登录 Azure 订阅，并按照屏幕上的说明操作。

Connect-AzAccount

如果你不知道要使用哪个位置，可以列出可用的位置。 使用以下代码示例显示位置列表，并找到要使用的位置。 本示例使用 eastus。 将位置存储在变量中，并使用该变量，这样就可以在一个位置更改它。

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

创建资源组

使用 New-AzResourceGroup 创建 Azure 资源组。 资源组是在其中部署和管理 Azure 资源的逻辑容器。

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

创建依赖项资源

Azure 机器学习工作区依赖于以下 Azure 资源：

• Application Insights
• Azure Key Vault
• Azure 存储帐户

使用以下命令创建这些资源并检索每个资源的 Azure 资源管理器 ID：

注意

在运行以下命令之前，必须为订阅注册 Microsoft.Insights 资源提供程序。 这是一次性注册。 使用 Register-AzResourceProvider -ProviderNamespace Microsoft.Insights 执行注册。

1. 创建 Application Insights 实例：

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

2. 创建 Azure 密钥保管库：

   重要

   每个密钥保管库必须具有唯一的名称。 在以下示例中，将 MyKeyVault 替换为密钥保管库名称。

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

3. 创建 Azure 存储帐户：

   重要

   每个存储帐户都必须有唯一名称。 在以下示例中将 MyStorage 替换为存储帐户的名称。 在运行以下示例之前，可以使用 Get-AzStorageAccountNameAvailability -Name 'YourUniqueName' 验证名称。

   $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
   
   

创建工作区

注意

在运行以下命令之前，必须为订阅注册 Microsoft.MachineLearningServices 资源提供程序。 这是一次性注册。 使用 Register-AzResourceProvider -ProviderNamespace Microsoft.MachineLearningServices 执行注册。

以下命令创建工作区并将其配置为使用之前创建的服务。 它还将工作区配置为使用系统分配的托管标识，该标识用于访问这些服务。 有关将托管标识用于 Azure 机器学习的详细信息，请参阅设置对其他服务的身份验证一文。

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

获取工作区信息

要检索工作区列表，请使用以下命令：

Get-AzMLWorkspace

要检索有关特定工作区的信息，请提供名称和资源组信息：

Get-AzMLWorkspace -Name $Workspace -ResourceGroupName $ResourceGroup

创建工作区

警告

如果为工作区启用了软删除，则可以在删除后恢复它。 如果未启用软删除，或者选择永久删除工作区的选项，则无法恢复该工作区。 有关详细信息，请参阅恢复已删除的工作区。

若要删除不再需要的工作区，请使用以下命令：

Remove-AzMLWorkspace -Name $Workspace -ResourceGroupName $ResourceGroup

重要

删除某个工作区不会删除该工作区使用的 Application Insights、存储帐户、密钥保管库或容器注册表。

也可以删除资源组，这会删除该资源组中的工作区和所有其他 Azure 资源。 若要删除资源组，请使用以下命令：

Remove-AzResourceGroup -Name $ResourceGroup

后续步骤

若要检查工作区是否存在问题，请参阅如何使用工作区诊断。

若要了解如何将工作区移到新 Azure 订阅，请参阅如何移动工作区。

有关如何使用最新的安全更新使 Azure 机器学习保持最新状态的信息，请参阅漏洞管理。

要了解如何使用工作区训练 ML 模型，请参阅一天玩转 Azure 机器学习教程。