New-AzureRmResourceGroupDeployment
Adiciona uma implantação do Azure a um grupo de recursos.
Aviso
O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.
Sintaxe
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
O cmdlet New-AzureRmResourceGroupDeployment adiciona uma implantação a um grupo de recursos existente. Isso inclui os recursos que a implantação exige. Um recurso do Azure é uma entidade do Azure gerenciada pelo usuário, como um servidor de banco de dados, banco de dados, site, máquina virtual ou conta de armazenamento. Um grupo de recursos do Azure é uma coleção de recursos do Azure que são implantados como uma unidade, como o site, o servidor de banco de dados e os bancos de dados necessários para um site financeiro. Uma implantação de grupo de recursos usa um modelo para adicionar recursos a um grupo de recursos e os publica para que estejam disponíveis no Azure. Para adicionar recursos a um grupo de recursos sem usar um modelo, use o cmdlet New-AzureRmResource. Para adicionar uma implantação de grupo de recursos, especifique o nome de um grupo de recursos existente e um modelo de grupo de recursos. Um modelo de grupo de recursos é uma cadeia de caracteres JSON que representa um grupo de recursos para um serviço complexo baseado em nuvem, como um portal da Web. O modelo inclui espaços reservados para parâmetros para recursos necessários e valores de propriedade configuráveis, como nomes e tamanhos. Você pode encontrar muitos modelos na galeria de modelos do Azure ou pode criar seus próprios modelos. Você pode usar o cmdlet Get-AzureRmResourceGroupGalleryTemplate para localizar um modelo na galeria. Para usar um modelo personalizado para criar um grupo de recursos, especifique o parâmetro TemplateFile ou o parâmetro TemplateUri. Cada modelo tem parâmetros para propriedades configuráveis. Para especificar valores para os parâmetros do modelo, especifique o parâmetro TemplateParameterFile ou o parâmetro TemplateParameterObject . Como alternativa, você pode usar os parâmetros de modelo que são adicionados dinamicamente ao comando quando você especifica um modelo. Para usar parâmetros dinâmicos, digite-os no prompt de comando ou digite um sinal de subtração (-) para indicar um parâmetro e use a tecla Tab para percorrer os parâmetros disponíveis. Os valores de parâmetro de modelo inseridos no prompt de comando têm precedência sobre os valores em um objeto ou arquivo de parâmetro de modelo.
Exemplos
Exemplo 1: Usar um modelo personalizado e um arquivo de parâmetro para criar uma implantação
PS C:\>New-AzureRmResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json"Este comando cria uma nova implantação usando um modelo personalizado e um arquivo de modelo no disco. O comando usa o parâmetro TemplateFile para especificar o modelo e o parâmetro TemplateParameterFile para especificar um arquivo que contém parâmetros e valores de parâmetro.
Parâmetros
-ApiVersion
Especifica a versão da API suportada pelo provedor de recursos. Você pode especificar uma versão diferente da versão padrão.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-AsJob
Executar cmdlet em segundo plano
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure
| Tipo: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DeploymentDebugLogLevel
Especifica um nível de log de depuração. Os valores aceitáveis para este parâmetro são:
- RequestContent
- ResponseContent
- Todos
- Nenhuma
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Force
Força o comando a ser executado sem pedir a confirmação do usuário.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Mode
Especifica o modo de implantação. Os valores aceitáveis para este parâmetro são:
- Concluído
- Incremental No modo completo, o Gerenciador de Recursos exclui recursos que existem no grupo de recursos, mas não são especificados no modelo. No modo incremental, o Gerenciador de Recursos deixa inalterados os recursos que existem no grupo de recursos, mas não são especificados no modelo.
| Tipo: | DeploymentMode |
| Position: | Named |
| Default value: | Incremental |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Name
Especifica o nome da implantação do grupo de recursos a ser criada.
| Tipo: | String |
| Aliases: | DeploymentName |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Pre
Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ResourceGroupName
Especifica o nome do grupo de recursos a ser implantado.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-RollBackDeploymentName
A reversão para a implantação bem-sucedida com o nome fornecido no grupo de recursos não deve ser usada se -RollbackToLastDeployment for usado.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-RollbackToLastDeployment
A reversão para a última implantação bem-sucedida no grupo de recursos não deve estar presente se -RollBackDeploymentName for usado.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-TemplateFile
Especifica o caminho completo de um arquivo de modelo JSON. Pode ser um modelo personalizado ou um modelo de galeria salvo como um arquivo JSON, como um criado usando o cmdlet Save-AzureRmResourceGroupGalleryTemplate .
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-TemplateParameterFile
Especifica o caminho completo de um arquivo JSON que contém os nomes e valores dos parâmetros do modelo. Se um modelo tiver parâmetros, você deverá especificar os valores de parâmetro com o parâmetro TemplateParameterFile ou o parâmetro TemplateParameterObject . Os parâmetros do modelo são adicionados dinamicamente ao comando quando você especifica um modelo. Para usar os parâmetros dinâmicos, digite um sinal de subtração (-) para indicar um nome de parâmetro e, em seguida, use a tecla Tab para percorrer os parâmetros disponíveis.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-TemplateParameterObject
Especifica uma tabela de hash de nomes e valores de parâmetros de modelo.
Para obter ajuda com tabelas de hash no Windows PowerShell, digite Get-Help about_Hash_Tables.
Se um modelo tiver parâmetros, você deverá especificar valores de parâmetro.
Os parâmetros do modelo são adicionados dinamicamente ao comando quando você especifica um modelo.
| Tipo: | Hashtable |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-TemplateParameterUri
Especifica o URI de um arquivo de parâmetros de modelo.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-TemplateUri
Especifica o URI de um arquivo de modelo JSON. Esse arquivo pode ser um modelo personalizado ou um modelo de galeria que é salvo como um arquivo JSON, como usando Save-AzureRmResourceGroupGalleryTemplate.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-WhatIf
Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
Entradas
None
Saídas
Microsoft.Azure.Commands.ResourceManager.Models.PSResourceGroupDeployment