次の方法で共有


PowerShell を使用した割り当ての管理方法

重要

2026 年 7 月 11 日に、Blueprints (プレビュー) は非推奨になります。 既存のブループリントの定義と割り当てを Template Specsデプロイ スタックに移行します。 ブループリント アーティファクトは、デプロイ スタックの定義に使用される ARM JSON テンプレートまたは Bicep ファイルに変換されます。 アーティファクトを ARM リソースとして作成する方法については、次を参照してください。

ブループリント割り当ては、Az.Blueprint Azure PowerShell モジュールを使用して管理できます。 このモジュールは、割り当てのフェッチ、作成、更新、および削除をサポートしています。 モジュールはまた、既存のブループリント定義の詳細をフェッチすることもできます。 この記事では、モジュールをインストールして使用し始める方法について説明します。

Az.Blueprint モジュールを追加する

Azure PowerShell でブループリント割り当てを管理できるようにするには、モジュールを追加する必要があります。 このモジュールは、ローカルにインストールされた PowerShell、Azure Cloud Shell、または Azure PowerShell Docker イメージで使用できます。

基本要件

Azure Blueprints モジュールには、次のソフトウェアが必要です。

  • Azure PowerShell 1.5.0 以降。 インストールされていない場合は、こちらの手順に従ってください。
  • PowerShellGet 2.0.1 以上。 インストールされていない場合、または更新されていない場合は、こちらの手順に従ってください。

モジュールのインストール

PowerShell の Azure Blueprints モジュールは Az.Blueprint です。

  1. 管理 PowerShell プロンプトで次のコマンドを実行します。

    # Install the Azure Blueprints module from PowerShell Gallery
    Install-Module -Name Az.Blueprint
    

    Note

    Az.Accounts が既にインストールされている場合は、-AllowClobber を使用して強制的にインストールすることが必要になる可能性があります。

  2. モジュールがインポートされていて、適切なバージョン (0.2.6) であることを確認します。

    # Get a list of commands for the imported Az.Blueprint module
    Get-Command -Module 'Az.Blueprint' -CommandType 'Cmdlet'
    

ブループリントの定義を取得する

割り当てを扱うには、多くの場合、最初にブループリントの定義への参照を得る必要があります。 Get-AzBlueprint コマンドレットは、ブループリントの 1 つ以上の定義を取得します。 このコマンドレットは、-ManagementGroupId {mgId} を使用して管理グループから、または -SubscriptionId {subId} を使用してサブスクリプションからブループリントの定義を取得できます。 Nave パラメーターは、ブループリントの定義を取得しますが、ManagementGroupId または SubscriptionId と使用する必要があります。 返されるブループリントの定義をより明確にするために、VersionName と一緒に使用できます。 Version の代わりにスイッチ -LatestPublished を使用すれば、最も新しく公開されたバージョンが取得されます。

次の例では、Get-AzBlueprint を使用して、{subId} と表される特定のサブスクリプションから、「101-blueprints-definition-subscription」というブループリントの定義のすべてのバージョンを取得します。

# Login first with Connect-AzAccount if not using Cloud Shell

# Get all versions of the blueprint definition in the specified subscription
$blueprints = Get-AzBlueprint -SubscriptionId '{subId}' -Name '101-blueprints-definition-subscription'

# Display the blueprint definition object
$blueprints

複数のバージョンがあるブループリントの定義の出力例は次のようになります。

Name                 : 101-blueprints-definition-subscription
Id                   : /subscriptions/{subId}/providers/Microsoft.Blueprint/blueprints/101
                       -blueprints-definition-subscription
DefinitionLocationId : {subId}
Versions             : {1.0, 1.1}
TimeCreated          : 2019-02-25
TargetScope          : Subscription
Parameters           : {storageAccount_storageAccountType, storageAccount_location,
                       allowedlocations_listOfAllowedLocations, [Usergrouporapplicationname]:Reader_RoleAssignmentName}
ResourceGroups       : ResourceGroup

ブループリントの定義のブループリントのパラメーターを展開して詳細情報を表示できます。

$blueprints.Parameters
Key                                                    Value
---                                                    -----
storageAccount_storageAccountType                      Microsoft.Azure.Commands.Blueprint.Models.PSParameterDefinition
storageAccount_location                                Microsoft.Azure.Commands.Blueprint.Models.PSParameterDefinition
allowedlocations_listOfAllowedLocations                Microsoft.Azure.Commands.Blueprint.Models.PSParameterDefinition
[Usergrouporapplicationname]:Reader_RoleAssignmentName Microsoft.Azure.Commands.Blueprint.Models.PSParameterDefinition

ブループリント割り当てを取得する

ブループリント割り当てが既に存在する場合、その参照を Get-AzBlueprintAssignment コマンドレットで取得できます。 このコマンドレットは、省略可能なパラメーターとして SubscriptionIdName を取ります。 SubscriptionId が指定されていない場合、現在のサブスクリプション コンテキストが使用されます。

次の例では Get-AzBlueprintAssignment を使用して、「Assignment-lock-resource-groups」という単一のブループリント割り当てを、{subId} として表される特定のサブスクリプションから取得します。

# Login first with Connect-AzAccount if not using Cloud Shell

# Get the blueprint assignment in the specified subscription
$blueprintAssignment = Get-AzBlueprintAssignment -SubscriptionId '{subId}' -Name 'Assignment-lock-resource-groups'

# Display the blueprint assignment object
$blueprintAssignment

ブループリント割り当ての出力例は、次のようになります。

Name              : Assignment-lock-resource-groups
Id                : /subscriptions/{subId}/providers/Microsoft.Blueprint/blueprintAssignme
                    nts/Assignment-lock-resource-groups
Scope             : /subscriptions/{subId}
LastModified      : 2019-02-19
LockMode          : AllResourcesReadOnly
ProvisioningState : Succeeded
Parameters        :
ResourceGroups    : ResourceGroup

ブループリント割り当てを作成する

ブループリント割り当てがまだ存在しない場合は、New-AzBlueprintAssignment コマンドレットを使用して作成できます。 このコマンドレットは、次のパラメーターを使用します。

  • Name [必須]

    • ブループリント割り当ての名前を指定します
    • 一意であり、SubscriptionId にまだ存在していないことが必要です
  • Blueprint [必須]

    • 割り当てるブループリントの定義を指定します
    • Get-AzBlueprint を使用して参照オブジェクトを取得します
  • Location [必須]

    • システム割り当てマネージド ID およびサブスクリプションのデプロイ オブジェクトを作成するリージョンを選択します
  • Subscription (オプション)

    • 割り当てのデプロイ先のサブスクリプションを指定します
    • 指定されていない場合、既定で現在のサブスクリプション コンテキストに設定されます
  • Lock (オプション)

    • デプロイされたリソースに使用するブループリントのリソース ロックを定義します
    • サポートされているオプション:NoneAllResourcesReadOnlyAllResourcesDoNotDelete
    • 指定しない場合、既定で None に設定されます
  • SystemAssignedIdentity (オプション)

    • 割り当てのシステム割り当てマネージド ID を作成し、リソースをデプロイするときに選択します
    • 「identity」パラメーター セットの既定値
    • UserAssignedIdentity とは使用できません
  • UserAssignedIdentity (オプション)

    • 割り当てに使用し、リソースをデプロイするユーザー割り当てマネージド ID を指定します
    • 「identity」パラメーター セットの一部
    • SystemAssignedIdentity とは使用できません
  • Parameter (オプション)

    • ブループリント割り当てで動的パラメーターを設定するためのキー/値のペアのハッシュ テーブル

    • 動的パラメーターの既定値は定義の defaultValue です

    • パラメーターが指定されておらず、defaultValue がない場合、パラメーターは省略できません

      Note

      Parameter は secureStrings をサポートしていません。

  • ResourceGroupParameter (オプション)

    • リソース グループのアーティファクトのハッシュ テーブル
    • 各リソース グループのアーティファクト プレースホルダーには、そのリソース グループ アーティファクトに Name および Location を動的に設定するための、キー/値のペアがあります
    • リソース グループ パラメーターが指定されておらず、defaultValue がない場合、リソース グループ パラメーターは省略できません
  • AssignmentFile (省略可能)

    • ブループリント割り当ての JSON ファイル表現へのパス
    • このパラメーターは、NameBlueprintSubscriptionId、および共通のパラメーターのみを含む PowerShell パラメーター セットの一部です。

例 1:パラメーターを指定する

次の例では、Get-AzBlueprint でフェッチされたバージョン「1.1」の「my-blueprint」ブループリント定義の新しい割り当てを作成し、マネージド ID と割り当てオブジェクトの場所を「westus2」に設定し、AllResourcesReadOnly でリソースをロックし、ParametersResourceGroupParameter の両方のハッシュ テーブルを、{subId} と表される特定のサブスクリプション上で設定します。

# Login first with Connect-AzAccount if not using Cloud Shell

# Get version '1.1' of the blueprint definition in the specified subscription
$bpDefinition = Get-AzBlueprint -SubscriptionId '{subId}' -Name 'my-blueprint' -Version '1.1'

# Create the hash table for Parameters
$bpParameters = @{storageAccount_storageAccountType='Standard_GRS'}

# Create the hash table for ResourceGroupParameters
# ResourceGroup is the resource group artifact placeholder name
$bpRGParameters = @{ResourceGroup=@{name='storage_rg';location='westus2'}}

# Create the new blueprint assignment
$bpAssignment = New-AzBlueprintAssignment -Name 'my-blueprint-assignment' -Blueprint $bpDefinition `
    -SubscriptionId '{subId}' -Location 'westus2' -Lock AllResourcesReadOnly `
    -Parameter $bpParameters -ResourceGroupParameter $bpRGParameters

ブループリント割り当ての作成の出力例は、次のようになります。

Name              : my-blueprint-assignment
Id                : /subscriptions/{subId}/providers/Microsoft.Blueprint/blueprintAssi
                    gnments/my-blueprint-assignment
Scope             : /subscriptions/{subId}
LastModified      : 2019-03-13
LockMode          : AllResourcesReadOnly
ProvisioningState : Creating
Parameters        : {storageAccount_storageAccountType}
ResourceGroups    : ResourceGroup

例 2:JSON 割り当て定義ファイルを使用する

以下の例では、例 1 とほぼ同じ割り当てを作成します。 パラメーターをコマンドレットに渡す代わりに、この例では、JSON 割り当て定義ファイルと AssignmentFile パラメーターの使用について示します。 さらに、excludedPrincipals プロパティを locks の一部として構成します。 excludedPrincipals に対応する PowerShell パラメーターは存在せず、このプロパティは JSON 割り当て定義ファイルを通じて設定することによってのみ構成できます。

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "westus2",
  "properties": {
    "description": "Assignment of the 101-blueprint-definition-subscription",
    "blueprintId": "/subscriptions/{subId}/providers/Microsoft.Blueprint/blueprints/101-blueprints-definition-subscription",
    "locks": {
      "mode": "AllResourcesReadOnly",
      "excludedPrincipals": [
          "7be2f100-3af5-4c15-bcb7-27ee43784a1f",
          "38833b56-194d-420b-90ce-cff578296714"
      ]
    },
    "parameters": {
      "storageAccount_storageAccountType": {
        "value": "Standard_GRS"
      }
    },
    "resourceGroups": {
      "ResourceGroup": {
        "name": "storage_rg",
        "location": "westus2"
      }
    }
  }
}
# Login first with Connect-AzAccount if not using Cloud Shell

# Create the new blueprint assignment
$bpAssignment = New-AzBlueprintAssignment -Name 'my-blueprint-assignment' -SubscriptionId '{subId}' `
    -AssignmentFile '.\assignment.json'

ユーザー割り当てマネージド ID の JSON 割り当て定義ファイルの例については、REST API のユーザー割り当てマネージド ID による割り当ての例の要求本文を参照してください。

ブループリント割り当てを更新する

既に作成されているブループリント割り当てを更新する必要が生じる場合があります。 Set-AzBlueprintAssignment コマンドレットがこのアクションを処理します。 このコマンドレットは、New-AzBlueprintAssignment コマンドレットと同じパラメーターの多くを使用し、割り当てで設定されたすべてのものを更新できるようにします。 例外は、NameBlueprint、および SubscriptionId です。 指定された値だけが更新されます。

ブループリント割り当ての更新時に行われる処理を理解するには、「割り当ての更新の規則」を参照してください。

  • Name [必須]

    • 更新するブループリント割り当ての名前を指定します
    • 割り当てを変更するのではなく、更新する割り当てを検索するために使用します
  • Blueprint [必須]

    • ブループリント割り当てのブループリント定義を指定します
    • Get-AzBlueprint を使用して参照オブジェクトを取得します
    • 割り当てを変更するのではなく、更新する割り当てを検索するために使用します
  • Location (オプション)

    • システム割り当てマネージド ID およびサブスクリプションのデプロイ オブジェクトを作成するリージョンを選択します
  • Subscription (オプション)

    • 割り当てのデプロイ先のサブスクリプションを指定します
    • 指定されていない場合、既定で現在のサブスクリプション コンテキストに設定されます
    • 割り当てを変更するのではなく、更新する割り当てを検索するために使用します
  • Lock (オプション)

  • SystemAssignedIdentity (オプション)

    • 割り当てのシステム割り当てマネージド ID を作成し、リソースをデプロイするときに選択します
    • 「identity」パラメーター セットの既定値
    • UserAssignedIdentity とは使用できません
  • UserAssignedIdentity (オプション)

    • 割り当てに使用し、リソースをデプロイするユーザー割り当てマネージド ID を指定します
    • 「identity」パラメーター セットの一部
    • SystemAssignedIdentity とは使用できません
  • Parameter (オプション)

    • ブループリント割り当てで動的パラメーターを設定するためのキー/値のペアのハッシュ テーブル

    • 動的パラメーターの既定値は定義の defaultValue です

    • パラメーターが指定されておらず、defaultValue がない場合、パラメーターは省略できません

      Note

      Parameter は secureStrings をサポートしていません。

  • ResourceGroupParameter (オプション)

    • リソース グループのアーティファクトのハッシュ テーブル
    • 各リソース グループのアーティファクト プレースホルダーには、そのリソース グループ アーティファクトに Name および Location を動的に設定するための、キー/値のペアがあります
    • リソース グループ パラメーターが指定されておらず、defaultValue がない場合、リソース グループ パラメーターは省略できません

次の例では、ロック モードを変更することによって Get-AzBlueprint でフェッチされたバージョン「1.1」の「my-blueprint」ブループリント定義の割り当てを更新します。

# Login first with Connect-AzAccount if not using Cloud Shell

# Get version '1.1' of the blueprint definition in the specified subscription
$bpDefinition = Get-AzBlueprint -SubscriptionId '{subId}' -Name 'my-blueprint' -Version '1.1'

# Update the existing blueprint assignment
$bpAssignment = Set-AzBlueprintAssignment -Name 'my-blueprint-assignment' -Blueprint $bpDefinition `
    -SubscriptionId '{subId}' -Lock AllResourcesDoNotDelete

ブループリント割り当ての作成の出力例は、次のようになります。

Name              : my-blueprint-assignment
Id                : /subscriptions/{subId}/providers/Microsoft.Blueprint/blueprintAssi
                    gnments/my-blueprint-assignment
Scope             : /subscriptions/{subId}
LastModified      : 2019-03-13
LockMode          : AllResourcesDoNotDelete
ProvisioningState : Updating
Parameters        : {storageAccount_storageAccountType}
ResourceGroups    : ResourceGroup

ブループリント割り当てを削除する

ブループリント割り当てを削除するときは、Remove-AzBlueprintAssignment コマンドレットがこのアクションを処理します。 このコマンドレットは、削除するブループリント割り当てを指定するために NameInputObject のどちらかを取ります。 SubscriptionId必須 であり、すべての場合で指定する必要があります。

次の例では、Get-AzBlueprintAssignment で既存のブループリント割り当てをフェッチした後、{subId} と表される特定のサブスクリプションからこれを削除します。

# Login first with Connect-AzAccount if not using Cloud Shell

# Get the blueprint assignment in the specified subscription
$blueprintAssignment = Get-AzBlueprintAssignment -Name 'Assignment-lock-resource-groups'

# Remove the existing blueprint assignment
Remove-AzBlueprintAssignment -InputObject $blueprintAssignment -SubscriptionId '{subId}'

コードの例

次の例ではすべての手順をまとめ、ブループリント定義を取得し、{subId} と表される特定のサブスクリプションでブループリント割り当てを作成、更新、および削除します。

# Login first with Connect-AzAccount if not using Cloud Shell

#region GetBlueprint
# Get version '1.1' of the blueprint definition in the specified subscription
$bpDefinition = Get-AzBlueprint -SubscriptionId '{subId}' -Name 'my-blueprint' -Version '1.1'
#endregion

#region CreateAssignment
# Create the hash table for Parameters
$bpParameters = @{storageAccount_storageAccountType='Standard_GRS'}

# Create the hash table for ResourceGroupParameters
# ResourceGroup is the resource group artifact placeholder name
$bpRGParameters = @{ResourceGroup=@{name='storage_rg';location='westus2'}}

# Create the new blueprint assignment
$bpAssignment = New-AzBlueprintAssignment -Name 'my-blueprint-assignment' -Blueprint $bpDefinition `
    -SubscriptionId '{subId}' -Location 'westus2' -Lock AllResourcesReadOnly `
    -Parameter $bpParameters -ResourceGroupParameter $bpRGParameters
#endregion CreateAssignment

# Wait for the blueprint assignment to finish deployment prior to the next steps

#region UpdateAssignment
# Update the existing blueprint assignment
$bpAssignment = Set-AzBlueprintAssignment -Name 'my-blueprint-assignment' -Blueprint $bpDefinition `
    -SubscriptionId '{subId}' -Lock AllResourcesDoNotDelete
#endregion UpdateAssignment

# Wait for the blueprint assignment to finish deployment prior to the next steps

#region RemoveAssignment
# Remove the existing blueprint assignment
Remove-AzBlueprintAssignment -InputObject $bpAssignment -SubscriptionId '{subId}'
#endregion

次のステップ