New-AzureRmResourceGroupDeployment
Agrega una implementación de Azure a un grupo de recursos.
Advertencia
El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.
Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.
Syntax
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>] Description
El cmdlet New-AzureRmResourceGroupDeployment agrega una implementación a un grupo de recursos existente. Esto incluye los recursos que requiere la implementación. Un recurso de Azure es una entidad de Azure administrada por el usuario, como un servidor de bases de datos, una base de datos, un sitio web, una máquina virtual o una cuenta de Storage. Un grupo de recursos de Azure es una colección de recursos de Azure que se implementan como una unidad, como el sitio web, el servidor de bases de datos y las bases de datos necesarias para un sitio web financiero. Una implementación de grupo de recursos usa una plantilla para agregar recursos a un grupo de recursos y publicarlos para que estén disponibles en Azure. Para agregar recursos a un grupo de recursos sin usar una plantilla, use el cmdlet New-AzureRmResource. Para agregar una implementación de grupo de recursos, especifique el nombre de un grupo de recursos existente y una plantilla de grupo de recursos. Una plantilla de grupo de recursos es una cadena JSON que representa un grupo de recursos para un servicio complejo basado en la nube, como un portal web. La plantilla incluye marcadores de posición de parámetros para los recursos necesarios y valores de propiedad configurables, como nombres y tamaños. Puede encontrar muchas plantillas en la galería de plantillas de Azure o puede crear sus propias plantillas. Puede usar el cmdlet Get-AzureRmResourceGroupGalleryTemplate para buscar una plantilla en la galería. Para usar una plantilla personalizada para crear un grupo de recursos, especifique el parámetro TemplateFile o el parámetro TemplateUri. Cada plantilla tiene parámetros para las propiedades configurables. Para especificar valores para los parámetros de plantilla, especifique el parámetro TemplateParameterFile o el parámetro TemplateParameterObject . Como alternativa, puede usar los parámetros de plantilla que se agregan dinámicamente al comando al especificar una plantilla. Para usar parámetros dinámicos, escríbalos en el símbolo del sistema o escriba un signo menos (-) para indicar un parámetro y use la tecla Tab para recorrer los parámetros disponibles. Los valores de parámetros de plantilla que escriba en el símbolo del sistema tienen prioridad sobre los valores de un objeto o archivo de parámetros de plantilla.
Ejemplos
Ejemplo 1: Uso de una plantilla personalizada y un archivo de parámetros para crear una implementación
PS C:\>New-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json"Este comando crea una nueva implementación mediante una plantilla personalizada y un archivo de plantilla en disco. El comando usa el parámetro TemplateFile para especificar la plantilla y el parámetro TemplateParameterFile para especificar un archivo que contenga los parámetros y sus valores correspondientes.
Parámetros
-ApiVersion
Especifica la versión de API compatible con el proveedor de recursos. Puede especificar una versión diferente de la versión predeterminada.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AsJob
Ejecución del cmdlet en segundo plano
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentDebugLogLevel
Especifica un nivel de registro de depuración. Los valores permitidos para este parámetro son los siguientes:
- RequestContent
- ResponseContent
- All
- None
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Mode
Especifica el modo de implementación. Los valores permitidos para este parámetro son los siguientes:
- Completo
- Incremental En modo completo, Resource Manager elimina los recursos que existen en el grupo de recursos, pero no se especifican en la plantilla. En el modo incremental, Resource Manager deja sin modificar los recursos que existen en el grupo de recursos pero que no se especifican en la plantilla.
| Type: | DeploymentMode |
| Position: | Named |
| Default value: | Incremental |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Especifica el nombre de la implementación del grupo de recursos que se va a crear.
| Type: | String |
| Aliases: | DeploymentName |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Pre
Indica que este cmdlet considera las versiones de API de versión preliminar cuando determina automáticamente qué versión se va a usar.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
Especifica el nombre del grupo de recursos que se va a implementar.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RollBackDeploymentName
La reversión a la implementación correcta con el nombre especificado en el grupo de recursos no se debe usar si se usa -RollbackToLastDeployment.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-RollbackToLastDeployment
La reversión a la última implementación correcta en el grupo de recursos no debe estar presente si se usa -RollBackDeploymentName.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TemplateFile
Especifica la ruta de acceso completa de un archivo de plantilla JSON. Puede ser una plantilla personalizada o una plantilla de galería que se guarda como un archivo JSON, como una creada mediante el cmdlet Save-AzureRmResourceGroupGalleryTemplate .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterFile
Especifica la ruta de acceso completa de un archivo JSON que contiene los nombres y los valores de los parámetros de plantilla. Si una plantilla tiene parámetros, debe especificar los valores de parámetro con el parámetro TemplateParameterFile o el parámetro TemplateParameterObject . Los parámetros de plantilla se agregan dinámicamente al comando al especificar una plantilla. Para usar los parámetros dinámicos, escriba un signo menos (-) para indicar un nombre de parámetro y, a continuación, use la tecla Tab para recorrer los parámetros disponibles.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterObject
Especifica una tabla hash de los nombres y valores de los parámetros de plantilla.
Para obtener ayuda con tablas hash en Windows PowerShell, escriba Get-Help about_Hash_Tables.
Si una plantilla tiene parámetros, debe especificar valores de parámetro.
Los parámetros de plantilla se agregan dinámicamente al comando al especificar una plantilla.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateParameterUri
Especifica el URI de un archivo de parámetros de plantilla.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TemplateUri
Especifica el URI de un archivo de plantilla JSON. Este archivo puede ser una plantilla personalizada o una plantilla de galería que se guarda como un archivo JSON, como save-AzureRmResourceGroupGalleryTemplate.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
None
Salidas
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment