Azure サブスクリプションでプレビュー機能を設定する

[アーティクル]
03/19/2024

この記事では、Azure サブスクリプションでプレビュー機能を管理する方法について説明します。プレビュー機能を使用すると、リリース前に新しい機能にオプトインできます。一部のプレビュー機能は、オプトインを希望するすべてのユーザーが利用できます。その他のプレビュー機能については、製品チームの承認が必要です。

Azure Feature Exposure Control (AFEC) は、Microsoft.Features 名前空間を通じて提供されます。プレビュー機能のリソース ID の形式は次のとおりです。

Microsoft.Features/providers/{resourceProviderNamespace}/features/{featureName}

必要なアクセス

Azure サブスクリプションでプレビュー機能の一覧表示、登録、または登録解除を行うには、Microsoft.Features/* アクションにアクセスする必要があります。このアクセス許可は、共同作成者と所有者の組み込みロールを通じて付与されます。カスタムロールを通じて必要なアクセスを指定することもできます。

プレビュー機能を一覧表示する

Azure サブスクリプションのすべてのプレビュー機能とその登録状態を一覧表示できます。

ポータルでは、機能を所有するサービスがプレビュー機能の管理エクスペリエンスに明示的にオプトインしている場合にのみ、プレビュー機能が表示されます。

Azure portal にサインインします。
検索ボックスに「サブスクリプション」と入力し、 [サブスクリプション] を選択します。
サブスクリプションの名前のリンクを選択します。
左側のメニューの [設定] で、 [プレビュー機能] を選択します。
使用可能なプレビュー機能と現在の登録状態の一覧が表示されます。
[プレビュー機能] では、名前、状態、または種類で一覧をフィルター処理できます。
- 名前でフィルター: 表示名ではなく、プレビュー機能の名前のテキストを含める必要があります。
- 状態: ドロップダウンメニューを選択し、状態を選択します。ポータルでは、"未登録" でフィルター処理することはできません。
- 種類: ドロップダウンメニューを選択し、種類を選択します。

サブスクリプションのすべてのプレビュー機能を一覧表示するには、az feature list コマンドを使用します。

Azure CLI の既定の出力は JSON です。その他の出力形式の詳細については、Azure CLI コマンドの出力形式に関するページを参照してください。

az feature list

{
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "NotRegistered"
  },
  "type": "Microsoft.Features/providers/features"
}

特定のリソースプロバイダーの出力をフィルター処理するには、namespace パラメーターを使用します。この例では、output パラメーターによってテーブル形式が指定されています。

az feature list --namespace Microsoft.Compute --output table

Name                                                RegistrationState
-------------------------------------------------   -------------------
Microsoft.Compute/AHUB                              Unregistered
Microsoft.Compute/AllowManagedDisksReplaceOSDisk    Registered
Microsoft.Compute/AllowPreReleaseRegions            Pending
Microsoft.Compute/InGuestPatchVMPreview             NotRegistered

特定のプレビュー機能の出力をフィルター処理するには、az feature show コマンドを使用します。

az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  NotRegistered

サブスクリプションのすべてのプレビュー機能を一覧表示するには、Get-AzProviderFeature コマンドレットを使用します。

Get-AzProviderFeature -ListAvailable

FeatureName      ProviderName     RegistrationState
-----------      ------------     -----------------
betaAccess       Microsoft.AAD    NotRegistered
previewAccess    Microsoft.AAD    Registered
tipAccess        Microsoft.AAD    Pending
testAccess       Microsoft.AAD    Unregistered

特定のリソースプロバイダーの出力をフィルター処理するには、ProviderNamespace パラメーターを使用します。既定の出力では、登録済みの機能のみが表示されます。リソースプロバイダーのすべてのプレビュー機能を表示するには、ListAvailable パラメーターと共に ProviderNamespace パラメーターを使用します。

Get-AzProviderFeature -ProviderNamespace "Microsoft.Compute" -ListAvailable

FeatureName                          ProviderName        RegistrationState
-----------                          ------------        -----------------
AHUB                                 Microsoft.Compute   Unregistered
AllowManagedDisksReplaceOSDisk       Microsoft.Compute   Registered
AllowPreReleaseRegions               Microsoft.Compute   Pending
InGuestPatchVMPreview                Microsoft.Compute   NotRegistered

FeatureName パラメーターを使用して、特定のプレビュー機能の出力をフィルター処理できます。

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   NotRegistered

プレビュー機能を登録する

リソースプロバイダーの機能をさらに公開するには、Azure サブスクリプションにプレビュー機能を登録します。一部のプレビュー機能は承認を必要とします。

サブスクリプションにプレビュー機能が登録されると、"登録済み" または "保留中" の 2 つの状態のどちらかが表示されます。

承認を必要としないプレビュー機能については、状態が "登録済み" になります。
プレビュー機能が承認を必要とする場合、登録状態は "保留中" になります。プレビュー機能を提供する Azure サービスの承認を要求する必要があります。通常、サポートチケットを通じてアクセスを要求します。
- 承認を要求するには、Azure サポートリクエストを送信します。
- 登録が承認されると、プレビュー機能の状態が "登録済み" に変わります。

一部のサービスでは、保留中の要求の承認を取得するために、メールなどの他の方法が必要です。アクセス権を取得する方法については、プレビュー機能に関するお知らせを確認してください。

Azure portal にサインインします。
検索ボックスに「サブスクリプション」と入力し、 [サブスクリプション] を選択します。
サブスクリプションの名前のリンクを選択します。
左側のメニューの [設定] で、 [プレビュー機能] を選択します。
登録するプレビュー機能のリンクを選択します。
[登録] を選択します。
[OK] を選択します。

[プレビュー機能] 画面が更新され、プレビュー機能の [状態] が表示されます。

プレビュー機能を登録するには、az feature register コマンドを使用します。

az feature register --name InGuestPatchVMPreview --namespace Microsoft.Compute

{
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "Registering"
  },
  "type": "Microsoft.Features/providers/features"
}

登録の状態を表示するには、az feature show コマンドを使用します。

az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  Registered

Note

プレビュー機能を登録するには、Register-AzProviderFeature コマンドレットを使用します。

Register-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Registering

登録の状態を表示するには、Get-AzProviderFeature コマンドレットを使用します。

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Registered

プレビュー機能の登録を解除する

プレビュー機能の使用が完了したら、Azure サブスクリプションから登録を解除します。機能の登録を解除すると、2 つの異なる状態のどちらかになります。ポータルを使用して登録を解除した場合、状態は "未登録" に設定されます。 Azure CLI、PowerShell、または REST API を使用して登録を解除した場合、状態は "登録解除" に設定されます。ポータルでは機能の登録が削除されますが、コマンドでは機能の登録が解除されるため、状態が異なります。どちらの場合も、この機能はサブスクリプションで使用できなくなります。どちらの場合も、再登録することで、この機能に再度オプトインすることができます。

[プレビュー機能] でプレビュー機能の登録を解除できます。 [状態] が "未登録" に変わります。

Azure portal にサインインします。
検索ボックスに「サブスクリプション」と入力し、 [サブスクリプション] を選択します。
サブスクリプションの名前のリンクを選択します。
左側のメニューの [設定] で、 [プレビュー機能] を選択します。
登録を解除するプレビュー機能のリンクを選択します。
[登録解除] を選択します。
[OK] を選択します。

プレビュー機能の登録を解除するには、az feature unregister コマンドを使用します。 RegistrationState 状態が "登録解除" に変わります。

az feature unregister --name InGuestPatchVMPreview --namespace Microsoft.Compute

{
  "id": "/subscriptions/11111111-1111-1111-1111-111111111111/providers/Microsoft.Features/providers/
    Microsoft.Compute/features/InGuestPatchVMPreview",
  "name": "Microsoft.Compute/InGuestPatchVMPreview",
  "properties": {
    "state": "Unregistering"
  },
  "type": "Microsoft.Features/providers/features"
}

登録解除の状態を表示するには、az feature show コマンドを使用します。

az feature show --name InGuestPatchVMPreview --namespace Microsoft.Compute --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  Unregistered

Note

unregister コマンドを実行すると、機能の登録解除後に、az provider register --namespace <provider-name> を実行して変更を反映するよう求めるメッセージが表示されます。

"登録解除" されたプレビュー機能を検索するには、次のコマンドを使用します。 <ResourceProvider.Name> をプロバイダー名 (Microsoft.Compute など) に置き換えます。

次の例では、Microsoft.Compute リソースプロバイダーの "登録解除" されたプレビュー機能を表示します。

az feature list --namespace <ResourceProvider.Name> --query "[?properties.state=='Unregistered'].{Name:name, RegistrationState:properties.state}" --output table

Name                                     RegistrationState
---------------------------------------  -------------------
Microsoft.Compute/InGuestPatchVMPreview  Unregistered

プレビュー機能の登録を解除するには、Unregister-AzProviderFeature コマンドレットを使用します。 RegistrationState 状態が "登録解除" に変わります。

Unregister-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistering

登録解除の状態を表示するには、Get-AzProviderFeature コマンドレットを使用します。

Get-AzProviderFeature -FeatureName "InGuestPatchVMPreview" -ProviderNamespace "Microsoft.Compute"

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistered

次の例では、Microsoft.Compute リソースプロバイダーの "登録解除" されたプレビュー機能を表示します。

Get-AzProviderFeature  -ProviderNamespace "Microsoft.Compute" -ListAvailable | Where-Object { $_.RegistrationState -eq "Unregistered" }

FeatureName             ProviderName        RegistrationState
-----------             ------------        -----------------
InGuestPatchVMPreview   Microsoft.Compute   Unregistered

Azure Policy を使用したプレビュー機能の構成

サブスクリプションがまだ登録されていない場合、ビルトインポリシー定義を使用して修復し、プレビュー機能に登録できます。既存のテナントに追加された新しいサブスクリプションは自動的には登録されません。

次のステップ

REST API 呼び出しを使用し、プレビュー機能の一覧表示、登録、または登録解除を行うには、「特徴」のドキュメントを参照してください。
リソースプロバイダーの登録方法の詳細については、「Azure リソースプロバイダーと種類」を参照してください。
リソースプロバイダーを Azure サービスにマップされるリストについては、「Resource providers for Azure services」 (Azure サービスのリソースプロバイダー) を参照してください。

次の方法で共有