你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
New-AzureRmResourceGroupDeployment
将 Azure 部署添加到资源组。
警告
截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 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 版本。 可以指定与默认版本不同的版本。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AsJob
在后台运行 cmdlet
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
用于与 azure 通信的凭据、帐户、租户和订阅
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentDebugLogLevel
指定调试日志级别。 此参数的可接受值为：
- RequestContent
- ResponseContent
- 全部
- 无
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
强制运行命令而不要求用户确认。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Mode
指定部署模式。 此参数的可接受值为：
- 完成
- 增量在完整模式下，资源管理器删除资源组中存在但未在模板中指定的资源。 在增量模式中，Resource Manager 保留资源组中已存在但尚未在模板中指定的资源。
| Type: | DeploymentMode |
| Position: | Named |
| Default value: | Incremental |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定要创建的资源组部署的名称。
| Type: | String |
| Aliases: | DeploymentName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Pre
指示此 cmdlet 在自动确定要使用的版本时会考虑预发布 API 版本。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
指定要部署的资源组的名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RollBackDeploymentName
如果使用 -RollbackToLastDeployment，则不应使用资源组中具有给定名称的成功部署。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RollbackToLastDeployment
如果使用 -RollBackDeploymentName，则不应在资源组中回滚到最后一个成功的部署。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TemplateFile
指定 JSON 模板文件的完整路径。 这可以是自定义模板，也可以是保存为 JSON 文件的库模板，例如使用 Save-AzureRmResourceGroupGalleryTemplate cmdlet 创建的模板。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterFile
指定包含模板参数名称和值的 JSON 文件的完整路径。 如果模板具有参数，则必须使用 TemplateParameterFile 参数或 TemplateParameterObject 参数指定参数值。 指定模板时，模板参数会动态添加到命令。 若要使用动态参数，请键入减号（-），以指示参数名称，然后使用 Tab 键循环访问可用参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterObject
指定模板参数名称和值的哈希表。
有关 Windows PowerShell 中哈希表的帮助，请键入 Get-Help about_Hash_Tables。
如果模板具有参数，则必须指定参数值。
指定模板时，模板参数会动态添加到命令。
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterUri
指定模板参数文件的 URI。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateUri
指定 JSON 模板文件的 URI。 此文件可以是自定义模板，也可以是保存为 JSON 文件的库模板，例如使用 Save-AzureRmResourceGroupGalleryTemplate。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
None
输出
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment