你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzBlueprintArtifact

预览

模块:: Az.Blueprint Module

此 cmdlet 是预览模块的一部分。不建议在生产环境中使用预览版本。有关详细信息，请参阅 https://aka.ms/azps-refstatus。

创建新项目并将其保存在蓝图定义中。

语法

CreateTemplateArtifact （默认值）

New-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>]

CreateArtifactByInputFile

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

CreateRoleAssignmentArtifact

New-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>]

CreatePolicyArtifact

New-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>]

说明

创建新项目。可通过两种方法创建项目：通过项目 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-account

通过 ARM 模板文件创建新项目。

参数

-ArtifactFile

磁盘上 JSON 格式的项目文件的位置。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateArtifactByInputFile

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Blueprint

Blueprint 对象。

参数属性

类型:	PSBlueprintBase
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateTemplateArtifact

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateRoleAssignmentArtifact

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreatePolicyArtifact

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DependsOn

在创建当前项目之前需要创建的项目的名称列表。

参数属性

类型:	List<T>[String]
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateTemplateArtifact

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CreateRoleAssignmentArtifact

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CreatePolicyArtifact

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Description

项目的说明。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateTemplateArtifact

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CreateRoleAssignmentArtifact

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CreatePolicyArtifact

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Name

项目的名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-PolicyDefinitionId

策略定义的定义 ID。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreatePolicyArtifact

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-PolicyDefinitionParameter

要传递给策略定义项目的参数的哈希表。

参数属性

类型:	Hashtable
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreatePolicyArtifact

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ResourceGroupName

项目要位于的资源组的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateTemplateArtifact

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CreateRoleAssignmentArtifact

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CreatePolicyArtifact

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-RoleDefinitionId

角色定义列表

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateRoleAssignmentArtifact

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-RoleDefinitionPrincipalId

角色定义主体 ID 的列表。

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateRoleAssignmentArtifact

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-TemplateFile

磁盘上的 ARM 模板文件的位置。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateTemplateArtifact

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-TemplateParameterFile

磁盘上的 ARM 模板参数文件的位置。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateTemplateArtifact

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-Type

项目的类型。支持 3 种类型：RoleAssignmentArtifact、PolicyAssignmentArtifact、TemplateArtifact。

参数属性

类型:	PSArtifactKind
默认值:	None
接受的值:	RoleAssignmentArtifact, PolicyAssignmentArtifact, TemplateArtifact
支持通配符:	False
不显示:	False

参数集

CreateTemplateArtifact

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CreateRoleAssignmentArtifact

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

CreatePolicyArtifact

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

New-AzBlueprintArtifact

语法

CreateTemplateArtifact （默认值）

CreateArtifactByInputFile

CreateRoleAssignmentArtifact

CreatePolicyArtifact

说明

示例

示例 1

示例 2

示例 3

参数

-ArtifactFile

参数属性

参数集

-Blueprint

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-DependsOn

参数属性

参数集

-Description

参数属性

参数集

-Name

参数属性

参数集

-PolicyDefinitionId

参数属性

参数集

-PolicyDefinitionParameter

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-RoleDefinitionId

参数属性

参数集

-RoleDefinitionPrincipalId

参数属性

参数集

-TemplateFile

参数属性

参数集

-TemplateParameterFile

参数属性

参数集

-Type

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

String

PSArtifactKind

PSBlueprintBase

List<T>

Hashtable

String

输出

Artifact