次の方法で共有


Set-AzBlueprintArtifact

このコマンドレットは 、プレビュー モジュールの一部です。 プレビュー バージョンは、運用環境で使用することはお勧めしません。 詳細については、https://aka.ms/azps-refstatusを参照してください。

ブループリント定義の成果物を更新します。

構文

UpdateTemplateArtifact (既定)

Set-AzBlueprintArtifact
    -Name <String>
    -Type <PSArtifactKind>
    -Blueprint <PSBlueprintBase>
    -TemplateParameterFile <String>
    -TemplateFile <String>
    [-Description <String>]
    [-DependsOn <System.Collections.Generic.List`1[System.String]>]
    [-ResourceGroupName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateArtifactByInputFile

Set-AzBlueprintArtifact
    -Name <String>
    -Blueprint <PSBlueprintBase>
    -ArtifactFile <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateRoleAssignmentArtifact

Set-AzBlueprintArtifact
    -Name <String>
    -Type <PSArtifactKind>
    -Blueprint <PSBlueprintBase>
    -RoleDefinitionId <String>
    -RoleDefinitionPrincipalId <String[]>
    [-Description <String>]
    [-DependsOn <System.Collections.Generic.List`1[System.String]>]
    [-ResourceGroupName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdatePolicyAssignmentArtifact

Set-AzBlueprintArtifact
    -Name <String>
    -Type <PSArtifactKind>
    -Blueprint <PSBlueprintBase>
    -PolicyDefinitionId <String>
    -PolicyDefinitionParameter <Hashtable>
    [-Description <String>]
    [-DependsOn <System.Collections.Generic.List`1[System.String]>]
    [-ResourceGroupName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

成果物を更新します。 アーティファクトを更新するには、2 つの方法があります。成果物 JSON を入力ファイルとして使用するか、成果物のインライン パラメーターを指定します。 JSON メソッドでは、インライン パラメーター メソッドを提供するために成果物の型を必要としませんが、ユーザーは -Type パラメーターを使用して成果物の型を指定する必要があります。

例 1

$bp = Get-AzBlueprint -Name SimpleBlueprint
Set-AzBlueprintArtifact -Name PolicyStorage -Blueprint $bp -ArtifactFile C:\PolicyAssignmentStorageTag.json
DisplayName        :
Description        : Apply storage tag and the parameter also used by the template to resource groups
DependsOn          :
PolicyDefinitionId : /providers/Microsoft.Authorization/policyDefinitions/49c88fc8-6fd1-46fd-a676-f12d1d3a4c71
Parameters         : {[tagName, Microsoft.Azure.Commands.Blueprint.Models.PSParameterValue], [tagValue, Microsoft.Azure.Commands.Blueprint.Models.PSParameterValue]}
ResourceGroup      :
Id                 : /subscriptions/{subscriptionId}/providers/Microsoft.Blueprint/blueprints/AppNetwork/artifacts/PolicyAssignmentStorageTag
Type               : Microsoft.Blueprint/blueprints/artifacts
Name               : PolicyAssignmentStorageTag

アーティファクト JSON ファイルを使用して成果物を更新します。

例 2

$bp = Get-AzBlueprint -Name SimpleBlueprint
Set-AzBlueprintArtifact -Type PolicyAssignmentArtifact -Name "ApplyTag-RG" -Blueprint $bp -PolicyDefinitionId "/providers/Microsoft.Authorization/policyDefinitions/49c88fc8-6fd1-46fd-a676-f12d1d3a4c71" -PolicyDefinitionParameter @{tagName="[parameters('tagName')]"; tagValue="[parameters('tagValue')]"} -ResourceGroupName storageRG
DisplayName        : ApplyTag-RG
Description        :
DependsOn          :
PolicyDefinitionId : /providers/Microsoft.Authorization/policyDefinitions/49c88fc8-6fd1-46fd-a676-f12d1d3a4c71
Parameters         : {[tagValue, Microsoft.Azure.Commands.Blueprint.Models.PSParameterValue], [tagName,
                     Microsoft.Azure.Commands.Blueprint.Models.PSParameterValue]}
ResourceGroup      : storageRG
Id                 : /subscriptions/28cbf98f-381d-4425-9ac4-cf342dab9753/providers/Microsoft.Blueprint/blueprints/AppNetwork/
                     artifacts/ApplyTag-RG
Type               : Microsoft.Blueprint/blueprints/artifacts
Name               : ApplyTag-RG

インライン パラメーターを使用して成果物を更新します。

例 3

$bp = Get-AzBlueprint -Name SimpleBlueprint
Set-AzBlueprintArtifact -Type TemplateArtifact -Name storage-account -Blueprint $bp -TemplateFile C:\StorageAccountArmTemplate.json -ResourceGroupName "storageRG" -TemplateParameterFile C:\Workspace\BlueprintTemplates\RestTemplatesSomeInline\StorageAccountParameters.json
DisplayName   : storage-account
Description   :
DependsOn     :
Template      : {$schema, contentVersion, parameters, variables...}
Parameters    : {}
ResourceGroup : storageRG
Id            : /subscriptions/{subscriptionId}/providers/Microsoft.Blueprint/blueprints/AppNetwork/artifacts/storage-account
Type          : Microsoft.Blueprint/blueprints/artifacts
Name          : storage-account

ARM テンプレート ファイルを使用して成果物を更新します。

パラメーター

-ArtifactFile

ディスク上の JSON 形式の成果物ファイルの場所。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateArtifactByInputFile
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Blueprint

ブループリント オブジェクト。

パラメーターのプロパティ

型:PSBlueprintBase
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateTemplateArtifact
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdateRoleAssignmentArtifact
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
UpdatePolicyAssignmentArtifact
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DependsOn

現在の成果物を作成する前に作成する必要がある成果物の名前の一覧。

パラメーターのプロパティ

型:

List<T>[String]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateTemplateArtifact
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
UpdateRoleAssignmentArtifact
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
UpdatePolicyAssignmentArtifact
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Description

成果物の説明。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateTemplateArtifact
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
UpdateRoleAssignmentArtifact
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
UpdatePolicyAssignmentArtifact
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Name

成果物の名前

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-PolicyDefinitionId

ポリシー定義の定義 ID。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdatePolicyAssignmentArtifact
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-PolicyDefinitionParameter

ポリシー定義成果物に渡すパラメーターのハッシュテーブル。

パラメーターのプロパティ

型:Hashtable
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdatePolicyAssignmentArtifact
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ResourceGroupName

アーティファクトが存在するリソース グループの名前。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateTemplateArtifact
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
UpdateRoleAssignmentArtifact
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
UpdatePolicyAssignmentArtifact
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-RoleDefinitionId

ロール定義の一覧

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateRoleAssignmentArtifact
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-RoleDefinitionPrincipalId

ロール定義プリンシパル ID の一覧。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateRoleAssignmentArtifact
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-TemplateFile

ディスク上の ARM テンプレート ファイルの場所。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateTemplateArtifact
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-TemplateParameterFile

ディスク上の ARM テンプレート パラメーター ファイルの場所。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateTemplateArtifact
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Type

成果物の種類。 RoleAssignmentArtifact、PolicyAssignmentArtifact、TemplateArtifact の 3 種類がサポートされています。

パラメーターのプロパティ

型:PSArtifactKind
規定値:None
指定可能な値:RoleAssignmentArtifact, PolicyAssignmentArtifact, TemplateArtifact
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

UpdateTemplateArtifact
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
UpdateRoleAssignmentArtifact
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False
UpdatePolicyAssignmentArtifact
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

String

PSArtifactKind

PSBlueprintBase

List<T>

Hashtable

String

出力

Artifact