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

New-AzureRmResourceGroupDeployment

模块:

AzureRM.Resources

将 Azure 部署添加到资源组。

警告

AzureRM PowerShell 模块已自 2024 年 2 月 29 日起正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可运行，但不再受到维护或支持，任何继续使用的行为都由用户自行决定并自行承担风险。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterObject <Hashtable>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterFile <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateFile <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateParameterUri <String>
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmResourceGroupDeployment
   [-Name <String>]
   -ResourceGroupName <String>
   [-Mode <DeploymentMode>]
   [-DeploymentDebugLogLevel <String>]
   [-RollbackToLastDeployment]
   [-RollBackDeploymentName <String>]
   [-Force]
   [-AsJob]
   -TemplateUri <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

New-AzureRmResourceGroupDeployment cmdlet 将部署添加到现有资源组。 这包括部署所需的资源。 Azure 资源是用户管理的 Azure 实体，例如数据库服务器、数据库、网站、虚拟机或存储帐户。 Azure 资源组是一组 Azure 资源，这些资源部署为单元，例如网站、数据库服务器和财务网站所需的数据库。 资源组部署使用模板将资源添加到资源组并发布资源，使其在 Azure 中可用。 若要在不使用模板的情况下将资源添加到资源组，请使用 New-AzureRmResource cmdlet。 若要添加资源组部署，请指定现有资源组和资源组模板的名称。 资源组模板是一个 JSON 字符串，表示复杂基于云的服务的资源组，例如 Web 门户。 该模板包括所需资源和可配置属性值的参数占位符，例如名称和大小。 可以在 Azure 模板库中找到许多模板，也可以创建自己的模板。 可以使用 Get-AzureRmResourceGroupGalleryTemplate cmdlet 在库中查找模板。 若要使用自定义模板创建资源组，请指定 TemplateFile 参数或 TemplateUri 参数。 每个模板都有可配置属性的参数。 若要指定模板参数的值，请指定 TemplateParameterFile 参数或 TemplateParameterObject 参数。 或者，可以在指定模板时使用动态添加到命令的模板参数。 若要使用动态参数，请在命令提示符下键入它们，或键入减号（-），以指示参数，并使用 Tab 键循环访问可用参数。 在命令提示符处输入的模板参数值优先于模板参数对象或文件中的值。

示例

示例 1：使用自定义模板和参数文件创建部署

PS C:\>New-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json"

此命令使用自定义模板和磁盘上的模板文件创建新的部署。 该命令使用 TemplateFile 参数来指定模板，并使用 TemplateParameterFile 参数指定包含参数和参数值的文件 。

参数

-ApiVersion

指定资源提供程序支持的 API 版本。 可以指定与默认版本不同的版本。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AsJob

在后台运行 cmdlet

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

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

类型:	IAzureContextContainer
别名:	AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DeploymentDebugLogLevel

指定调试日志级别。 此参数的可接受值为：

• RequestContent
• ResponseContent
• All
• 无

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Force

强制运行命令而不要求用户确认。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Mode

指定部署模式。 此参数的可接受值为：

• 完成
• 增量在完整模式下，资源管理器删除资源组中存在但未在模板中指定的资源。 在增量模式中，Resource Manager 保留资源组中已存在但尚未在模板中指定的资源。

类型:	DeploymentMode
Position:	Named
默认值:	Incremental
必需:	False
接受管道输入:	True
接受通配符:	False

-Name

指定要创建的资源组部署的名称。

类型:	String
别名:	DeploymentName
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Pre

指示此 cmdlet 在自动确定要使用的版本时会考虑预发布 API 版本。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

指定要部署的资源组的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-RollBackDeploymentName

如果使用 -RollbackToLastDeployment，则不应使用资源组中具有给定名称的成功部署。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-RollbackToLastDeployment

如果使用 -RollBackDeploymentName，则不应在资源组中回滚到最后一个成功的部署。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TemplateFile

指定 JSON 模板文件的完整路径。 这可以是自定义模板，也可以是保存为 JSON 文件的库模板，例如使用 Save-AzureRmResourceGroupGalleryTemplate cmdlet 创建的模板。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-TemplateParameterFile

指定包含模板参数名称和值的 JSON 文件的完整路径。 如果模板具有参数，则必须使用 TemplateParameterFile 参数或 TemplateParameterObject 参数指定参数值。 指定模板时，模板参数会动态添加到命令。 若要使用动态参数，请键入减号（-），以指示参数名称，然后使用 Tab 键循环访问可用参数。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-TemplateParameterObject

指定模板参数名称和值的哈希表。 有关 Windows PowerShell 中哈希表的帮助，请键入 Get-Help about_Hash_Tables。 如果模板具有参数，则必须指定参数值。 指定模板时，模板参数会动态添加到命令。

类型:	Hashtable
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-TemplateParameterUri

指定模板参数文件的 URI。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-TemplateUri

指定 JSON 模板文件的 URI。 此文件可以是自定义模板，也可以是保存为 JSON 文件的库模板，例如使用 Save-AzureRmResourceGroupGalleryTemplate。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

输出

Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment

相关链接

• Get-AzureRmResourceGroupDeployment
• New-AzureRmResource
• New-AzureRmResourceGroup
• Remove-AzureRmResourceGroupDeployment
• Stop-AzureRmResourceGroupDeployment
• Test-AzureRmResourceGroupDeployment