New-AzBlueprintArtifact
新しい成果物を作成し、ブループリント定義内に保存します。
構文
New-AzBlueprintArtifact
-Name <String>
-Type <PSArtifactKind>
-Blueprint <PSBlueprintBase>
[-Description <String>]
[-DependsOn <System.Collections.Generic.List`1[System.String]>]
-TemplateParameterFile <String>
-TemplateFile <String>
[-ResourceGroupName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzBlueprintArtifact
-Name <String>
-Blueprint <PSBlueprintBase>
-ArtifactFile <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzBlueprintArtifact
-Name <String>
-Type <PSArtifactKind>
-Blueprint <PSBlueprintBase>
[-Description <String>]
[-DependsOn <System.Collections.Generic.List`1[System.String]>]
-RoleDefinitionId <String>
-RoleDefinitionPrincipalId <String[]>
[-ResourceGroupName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzBlueprintArtifact
-Name <String>
-Type <PSArtifactKind>
-Blueprint <PSBlueprintBase>
[-Description <String>]
[-DependsOn <System.Collections.Generic.List`1[System.String]>]
-PolicyDefinitionId <String>
-PolicyDefinitionParameter <Hashtable>
[-ResourceGroupName <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
新しい成果物を作成します。 アーティファクトを作成するには、2 つの方法があります。成果物 JSON を入力ファイルとして使用するか、成果物のインライン パラメーターを指定します。 JSON メソッドでは、インライン パラメーター メソッドを提供するために成果物の型を必要としませんが、ユーザーは -Type パラメーターを使用して成果物の型を指定する必要があります。
例
例 1
$bp = Get-AzBlueprint -Name SimpleBlueprint
New-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
New-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
New-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-accountARM テンプレート ファイルを使用して新しい成果物を作成します。
パラメーター
-ArtifactFile
ディスク上の JSON 形式の成果物ファイルの場所。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Blueprint
ブループリント オブジェクト。
| Type: | PSBlueprintBase |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DependsOn
現在の成果物を作成する前に作成する必要がある成果物の名前の一覧。
| Type: | List<T>[String] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Description
成果物の説明。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
成果物の名前
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PolicyDefinitionId
ポリシー定義の定義 ID。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PolicyDefinitionParameter
ポリシー定義成果物に渡すパラメーターのハッシュテーブル。
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
アーティファクトが存在するリソース グループの名前。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RoleDefinitionId
ロール定義の一覧
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RoleDefinitionPrincipalId
ロール定義プリンシパル ID の一覧。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateFile
ディスク上の ARM テンプレート ファイルの場所。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterFile
ディスク上の ARM テンプレート パラメーター ファイルの場所。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Type
成果物の種類。 RoleAssignmentArtifact、PolicyAssignmentArtifact、TemplateArtifact の 3 種類がサポートされています。
| Type: | PSArtifactKind |
| Accepted values: | RoleAssignmentArtifact, PolicyAssignmentArtifact, TemplateArtifact |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
String[]
出力
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Azure PowerShell
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示