Azure PowerShell を使用して Azure Machine Learning ワークスペースを管理する

[アーティクル]
09/13/2023

Azure Machine Learning 用の Azure PowerShell モジュールを使用して、Azure Machine Learning ワークスペースを作成し、管理します。 Azure Machine Learning 用の Azure PowerShell コマンドレットの完全な一覧については、Az.MachineLearningServices のリファレンスドキュメントを参照してください。

また、Azure CLI、Azure portal と Python SDK、または VS Code 拡張機能を使用してワークスペースを管理することもできます。

前提条件

Azure サブスクリプション。お持ちでない場合は、無料版または有料版の Azure Machine Learning をお試しください。
Azure PowerShell モジュール。最新バージョンがあることを確認するには、Azure PowerShell モジュールのインストールに関するページをご覧ください。

重要

Az.MachineLearningServices PowerShell モジュールがプレビュー段階にある間は、Install-Module コマンドレットを使用して、これを個別にインストールする必要があります。
```
Install-Module -Name Az.MachineLearningServices -Scope CurrentUser -Repository PSGallery -Force
```

Connect-AzAccount コマンドを使用して Azure サブスクリプションにサインインし、画面上の指示に従います。

Connect-AzAccount

使用する場所がわからない場合、利用できる場所を一覧表示できます。次のコード例を使用して場所の一覧を表示し、使用する場所を見つけます。この例では、eastus を使います。場所を変数に格納し、この変数を使用することで、1 か所で場所を変更できます。

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

リソースグループを作成する

New-AzResourceGroup を使用して Azure リソースグループを作成します。リソースグループとは、Azure リソースのデプロイと管理に使用する論理コンテナーです。

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

依存関係リソースを作成する

Azure Machine Learning ワークスペースは、次の Azure リソースに依存します。

Application Insights
Azure Key Vault
Azure Storage アカウント

これらのリソースを作成し、それぞれのアイテムの Azure Resource Manager ID を取得するには、次のコマンドを使用します。

注意

次のコマンドを実行する前に、サブスクリプションに Microsoft.Insights リソースプロバイダーを登録する必要があります。これは 1 回限りの登録です。 Register-AzResourceProvider -ProviderNamespace Microsoft.Insights を使用して登録を実行します。

Application Insights インスタンスを作成します。

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

Azure Key Vault を作成します。

重要

各キーコンテナーには一意の名前が必要です。次の例の MyKeyVault は、ご自分のキーコンテナーの名前に置き換えてください。
```
$KeyVault = 'MyKeyVault'
New-AzKeyVault -Name $KeyVault -ResourceGroupName $ResourceGroup -Location $Location
$kvid = (Get-AzResource -Name $KeyVault -ResourceGroupName $ResourceGroup).ResourceId
```
Azure Storage アカウントを作成します。

重要

ストレージアカウントには、それぞれ一意の名前が必要です。次の例の 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 リソースプロバイダーを登録する必要があります。これは 1 回限りの登録です。 Register-AzResourceProvider -ProviderNamespace Microsoft.MachineLearningServices を使用して登録を実行します。

次のコマンドを使用すると、ワークスペースが作成され、以前に作成済みのサービスを使用するように構成されます。また、ワークスペースは、これらのサービスへのアクセスに使用されるシステム割り当てマネージド ID を使用するように構成されます。 Azure Machine Learning でマネージド ID を使用する方法の詳細については、他のサービスに対する認証の設定に関する記事を参照してください。

$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 Machine Learning を最新の状態に保つ方法については、脆弱性の管理に関する記事を参照してください。

ワークスペースを使用して ML モデルをトレーニングする方法については、「1 日でわかる Azure Machine Learning」チュートリアルを参照してください。