Compartir a través de


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