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.
Sintaxis
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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-AsJob
Ejecución del cmdlet en segundo plano
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure
| Tipo: | IAzureContextContainer |
| Alias: | AzureRmContext, AzureCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DeploymentDebugLogLevel
Especifica un nivel de registro de depuración. Los valores permitidos para este parámetro son los siguientes:
- RequestContent
- ResponseContent
- All
- None
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Force
Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | DeploymentMode |
| Posición: | Named |
| Valor predeterminado: | Incremental |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Name
Especifica el nombre de la implementación del grupo de recursos que se va a crear.
| Tipo: | String |
| Alias: | DeploymentName |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ResourceGroupName
Especifica el nombre del grupo de recursos que se va a implementar.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-RollbackToLastDeployment
La reversión a la última implementación correcta en el grupo de recursos no debe estar presente si se usa -RollBackDeploymentName.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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 .
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | Hashtable |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-TemplateParameterUri
Especifica el URI de un archivo de parámetros de plantilla.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
None
Salidas
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment