Compartilhar via

New-AzResourceGroupDeployment

Módulo:
Az.Resources Module

Adiciona uma implantação do Azure a um grupo de recursos.

Sintaxe

ByTemplateFileWithNoParameters (Padrão) 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateFile <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateObjectAndParameterObject 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterObject <Hashtable>
    -TemplateObject <Hashtable>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateFileAndParameterObject 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterObject <Hashtable>
    -TemplateFile <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateUriAndParameterObject 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterObject <Hashtable>
    -TemplateUri <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateSpecResourceIdAndParamsObject 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterObject <Hashtable>
    -TemplateSpecId <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateObjectAndParameterFile 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterFile <String>
    -TemplateObject <Hashtable>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateFileAndParameterFile 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterFile <String>
    -TemplateFile <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateUriAndParameterFile 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterFile <String>
    -TemplateUri <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateSpecResourceIdAndParams 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterFile <String>
    -TemplateSpecId <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByParameterFileWithNoTemplate 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterFile <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateObjectAndParameterUri 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterUri <String>
    -TemplateObject <Hashtable>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateFileAndParameterUri 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterUri <String>
    -TemplateFile <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateUriAndParameterUri 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterUri <String>
    -TemplateUri <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateSpecResourceIdAndParamsUri 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateParameterUri <String>
    -TemplateSpecId <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateObjectWithNoParameters 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateObject <Hashtable>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateUriWithNoParameters 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateUri <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByTemplateSpecResourceId 

New-AzResourceGroupDeployment
    -ResourceGroupName <String>
    -TemplateSpecId <String>
    [-Name <String>]
    [-Mode <DeploymentMode>]
    [-DeploymentDebugLogLevel <String>]
    [-RollbackToLastDeployment]
    [-RollBackDeploymentName <String>]
    [-Tag <Hashtable>]
    [-WhatIfResultFormat <WhatIfResultFormat>]
    [-WhatIfExcludeChangeType <String[]>]
    [-Force]
    [-ProceedIfNoChange]
    [-AsJob]
    [-AuxTenant <String[]>]
    [-QueryString <String>]
    [-ValidationLevel <String>]
    [-SkipTemplateParameterPrompt]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet New-AzResourceGroupDeployment adiciona uma implantação a um grupo de recursos existente. Isso inclui os recursos necessários para a implantação. Um recurso do Azure é uma entidade do Azure gerenciada pelo usuário, como um servidor de banco de dados, um banco de dados, um site, uma máquina virtual ou uma conta de armazenamento. Um grupo de recursos do Azure é uma coleção de recursos do Azure 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 eles estejam disponíveis no Azure. Para adicionar recursos a um grupo de recursos sem usar um modelo, use o cmdlet New-AzResource. 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 de parâmetro 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. 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 de 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 ao especificar 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 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

New-AzResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateFile "D:\Azure\Templates\EngineeringSite.json" -TemplateParameterFile "D:\Azure\Templates\EngSiteParms.json" -Tag @{"key1"="value1"; "key2"="value2";}

Esse comando cria uma nova implantação usando um modelo personalizado e um arquivo de modelo em disco, com o parâmetro de marcas definido. 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.

Exemplo 2: usar um objeto de modelo personalizado e um arquivo de parâmetro para criar uma implantação

$TemplateFileText = [System.IO.File]::ReadAllText("D:\Azure\Templates\EngineeringSite.json")
$TemplateObject = ConvertFrom-Json $TemplateFileText -AsHashtable
New-AzResourceGroupDeployment -ResourceGroupName "ContosoEngineering" -TemplateObject $TemplateObject -TemplateParameterFile "D:\Azure\Templates\EngSiteParams.json"

Esse comando cria uma nova implantação usando um arquivo personalizado e um modelo no disco que foi convertido em um hashtable na memória. Os dois primeiros comandos leem o texto do arquivo de modelo no disco e o convertem em um hashtable na memória. O último comando usa o parâmetro TemplateObject para especificar o hashtable e o parâmetro TemplateParameterFile para especificar um arquivo que contém parâmetros e valores de parâmetro.

Exemplo 3

Adiciona uma implantação do Azure a um grupo de recursos. (autogenerated)

New-AzResourceGroupDeployment -DeploymentDebugLogLevel RequestContent -Name mynewstorageaccount -ResourceGroupName 'ContosoEngineering' -TemplateFile 'D:\Azure\Templates\EngineeringSite.json' -TemplateParameterObject <Hashtable>

Exemplo 4: implantar um modelo armazenado em uma conta de armazenamento não pública usando um uri e um token SAS

New-AzResourceGroupDeployment -ResourceGroupName "RGName" -TemplateUri "https://example.com/example.json" -QueryString "foo"

Esse comando cria uma nova implantação usando o modelo em TemplateUri, que não é público e requer um parâmetro de token para acessar que seria fornecido usando o parâmetro QueryString. A execução desse comando acessa efetivamente o modelo usando a URL https://example.com/example.json?foo. Isso pode ser usado se você quiser usar um modelo em uma conta de armazenamento fornecendo o token SAS como o QueryString

Exemplo 5: usar um arquivo .bicepparam para criar uma implantação

New-AzResourceGroupDeployment -ResourceGroupName "RGName"  -TemplateParameterFile "./parameters.bicepparam"

Esse comando cria uma nova implantação no escopo do grupo de recursos usando um arquivo .bicepparam no disco. O comando usa o parâmetro TemplateParameterFile para especificar um arquivo .bicepparam.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AuxTenant

IDs de locatário do Aux para implantações entre locatários

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DeploymentDebugLogLevel

Especifica um nível de log de depuração. Os valores aceitáveis para este parâmetro são:

  • RequestContent
  • ResponseContent
  • All
  • None

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Valores aceitos:RequestContent, ResponseContent, All, None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Mode

Especifica o modo de implantação. Os valores aceitáveis para este parâmetro são:

  • Concluído: no modo completo, o Resource Manager exclui os recursos que existem no grupo de recursos, mas não são especificados no modelo.
  • Incremental: no modo incremental, o Resource Manager deixa os recursos inalterados que existem no grupo de recursos, mas não são especificados no modelo.

Propriedades do parâmetro

Tipo:DeploymentMode
Valor padrão:Incremental
Valores aceitos:Incremental, Complete
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

O nome da implantação que ele vai criar. Se não for especificado, o padrão será o nome do arquivo de modelo quando um arquivo de modelo for fornecido; o padrão é a hora atual em que um objeto de modelo é fornecido, por exemplo, "20131223140835".

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:DeploymentName

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Pre

Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProceedIfNoChange

Não solicite confirmação se não houver alterações no resultado do What-If. Aplicável quando a opção -Confirm é definida.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-QueryString

A cadeia de caracteres de consulta (por exemplo, um token SAS) a ser usada com o parâmetro TemplateUri. Seria usado no caso de modelos vinculados

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

Especifica o nome do grupo de recursos a ser implantado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-RollBackDeploymentName

A reversão para a implantação bem-sucedida com o nome fornecido no grupo de recursos não deverá ser usada se -RollbackToLastDeployment for usado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-RollbackToLastDeployment

A reversão para a última implantação bem-sucedida no grupo de recursos não deverá estar presente se -RollBackDeploymentName for usado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SkipTemplateParameterPrompt

Ignora o processamento de parâmetro dinâmico do PowerShell que verifica se o parâmetro de modelo fornecido contém todos os parâmetros necessários usados pelo modelo. Essa verificação solicitará que o usuário forneça um valor para os parâmetros ausentes, mas fornecer o -SkipTemplateParameterPrompt ignorará esse prompt e o erro imediatamente se um parâmetro não tiver sido associado ao modelo. Para scripts não interativos, -SkipTemplateParameterPrompt pode ser fornecido para fornecer uma mensagem de erro melhor no caso em que nem todos os parâmetros necessários são atendidos.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Tag

As marcas a serem colocadas na implantação.

Propriedades do parâmetro

Tipo:Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TemplateFile

Especifica o caminho completo de um arquivo de modelo personalizado. Tipo de arquivo de modelo com suporte: json e bicep.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByTemplateFileWithNoParameters
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateFileAndParameterObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateFileAndParameterFile
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateFileAndParameterUri
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-TemplateObject

Uma tabela de hash que representa o modelo.

Propriedades do parâmetro

Tipo:Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByTemplateObjectAndParameterObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateObjectAndParameterFile
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateObjectAndParameterUri
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateObjectWithNoParameters
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-TemplateParameterFile

Especifica o caminho completo de um arquivo JSON que contém os nomes e valores dos parâmetros de 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 de 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 use a tecla Tab para percorrer os parâmetros disponíveis.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByTemplateObjectAndParameterFile
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateFileAndParameterFile
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateUriAndParameterFile
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateSpecResourceIdAndParams
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByParameterFileWithNoTemplate
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-TemplateParameterObject

Especifica uma tabela hash de valores e nomes de parâmetro 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 de modelo são adicionados dinamicamente ao comando quando você especifica um modelo.

Propriedades do parâmetro

Tipo:Hashtable
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByTemplateObjectAndParameterObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateFileAndParameterObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateUriAndParameterObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateSpecResourceIdAndParamsObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-TemplateParameterUri

Especifica o URI de um arquivo de parâmetros de modelo. Ao usar TemplateParameterUri, todos os parâmetros dinâmicos usados são desconsiderados. Para usar parâmetros dinâmicos, você deve usar o parâmetro TemplateParameterFile

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByTemplateObjectAndParameterUri
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateFileAndParameterUri
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateUriAndParameterUri
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateSpecResourceIdAndParamsUri
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-TemplateSpecId

ID do recurso do templateSpec a ser implantado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByTemplateSpecResourceIdAndParamsObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateSpecResourceIdAndParams
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateSpecResourceIdAndParamsUri
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateSpecResourceId
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-TemplateUri

Especifica o URI de um arquivo de modelo personalizado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ByTemplateUriAndParameterObject
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateUriAndParameterFile
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateUriAndParameterUri
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False
ByTemplateUriWithNoParameters
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ValidationLevel

Define o nível de validação para validar/e-se. ValidationLevel pode ser Template(Skips provider validation), Provider(Executes full validation) ou ProviderNoRbac(Executa validação completa usando verificações de leitura RBAC em vez de verificações de gravação RBAC para validação do provedor).

Propriedades do parâmetro

Tipo:String
Valor padrão:None(Provider)
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIfExcludeChangeType

Tipos de alteração de recurso separados por vírgula a serem excluídos dos resultados What-If. Aplicável quando a opção -WhatIf ou -Confirm é definida.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIfResultFormat

O formato de resultado What-If.

Propriedades do parâmetro

Tipo:WhatIfResultFormat
Valor padrão:None
Valores aceitos:ResourceIdOnly, FullResourcePayloads
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Microsoft.Azure.Management.ResourceManager.Models.DeploymentMode

Hashtable

Saídas

PSResourceGroupDeployment