New-AzTenantDeployment
Criar uma implantação no escopo do locatário
Syntax
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterObject <Hashtable>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterFile <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateFile <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateParameterUri <String>
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateObject <Hashtable>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateUri <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTenantDeployment
[-Name <String>]
-Location <String>
[-DeploymentDebugLogLevel <String>]
[-Tag <Hashtable>]
[-WhatIfResultFormat <WhatIfResultFormat>]
[-WhatIfExcludeChangeType <String[]>]
[-ProceedIfNoChange]
[-AsJob]
[-QueryString <String>]
-TemplateSpecId <String>
[-SkipTemplateParameterPrompt]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet New-AzTenantDeployment adiciona uma implantação no escopo do locatário atual.
Para adicionar uma implantação no escopo do locatário, especifique o local e um modelo. O local informa ao Gerenciador de Recursos do Azure onde armazenar os dados de implantação. O modelo é uma cadeia de caracteres JSON que contém recursos individuais a serem implantados. O modelo inclui espaços reservados de parâmetro para recursos necessários e valores de propriedade configuráveis, como nomes e tamanhos.
Para usar um modelo personalizado para a implantação, 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.
Para adicionar recursos a um grupo de recursos, use o New-AzResourceGroupDeployment que cria uma implantação em um grupo de recursos. Para adicionar recursos a uma assinatura, use o New-AzSubscriptionDeployment que cria uma implantação no escopo da assinatura, que implanta recursos de nível de assinatura. Para adicionar recursos em um grupo de gerenciamento, use o New-AzManagementGroupDeployment que cria uma implantação em um grupo de gerenciamento.
Exemplos
Exemplo 1: Usar um modelo personalizado e um arquivo de parâmetro para criar uma implantação
New-AzTenantDeployment -Location "West US" -TemplateFile "D:\Azure\Templates\OrgSetup.json" -TemplateParameterFile "D:\Azure\Templates\OrgParms.json" -Tag @{"key1"="value1"; "key2"="value2";}
Esse comando cria uma nova implantação no escopo do locatário atual usando um modelo personalizado e um arquivo de modelo no 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\OrgSetup.json")
$TemplateObject = ConvertFrom-Json $TemplateFileText -AsHashtable
New-AzTenantDeployment -Location "West US" -TemplateObject $TemplateObject -TemplateParameterFile "D:\Azure\Templates\OrgParams.json"
Esse comando cria uma nova implantação no locatário atual usando um modelo personalizado e um arquivo de modelo no disco que foi convertido em uma tabela de hash na memória. Os dois primeiros comandos leem o texto do arquivo de modelo no disco e o convertem em uma hashtable na memória. O último comando usa o parâmetro TemplateObject para especificar essa tabela de hash e o parâmetro TemplateParameterFile para especificar um arquivo que contém parâmetros e valores de parâmetro.
Exemplo 3: Usar um arquivo .bicepparam para criar uma implantação
New-AzTenantDeployment -Location "West US" -TemplateParameterFile "./parameters.bicepparam"
Esse comando cria uma nova implantação no escopo do locatário atual 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
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Tipo: | SwitchParameter |
Aliases: | cf |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentDebugLogLevel
O nível de log de depuração de implantação.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
O local para armazenar dados de implantação.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 quando um objeto de modelo é fornecido, por exemplo, "20131223140835".
Tipo: | String |
Aliases: | DeploymentName |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Pre
Quando definido, indica que o cmdlet deve usar versões de API de pré-lançamento ao determinar automaticamente qual versão usar.
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProceedIfNoChange
Não peça confirmação se não houver alterações no resultado do What-Like. Aplicável quando a opção -Confirm está definida.
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-QueryString
A cadeia de caracteres de consulta (por exemplo, um token SAS) a ser usada com o parâmetro TemplateUri. Seria usado em caso de modelos vinculados
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipTemplateParameterPrompt
Ignora o processamento de parâmetros dinâmicos 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 solicitaria que o usuário fornecesse um valor para os parâmetros ausentes, mas fornecer o -SkipTemplateParameterPrompt ignorará esse prompt e interromperá o erro imediatamente se um parâmetro não estiver vinculado 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 satisfeitos.
Tipo: | SwitchParameter |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
As tags a serem colocadas na implantação.
Tipo: | Hashtable |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateFile
Caminho local para o arquivo de modelo. Tipo de arquivo de modelo suportado: json e bicep.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateObject
Uma tabela de hash que representa o modelo.
Tipo: | Hashtable |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterFile
Arquivo de parâmetro a ser usado para o modelo.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterObject
Uma tabela de hash que representa os parâmetros.
Tipo: | Hashtable |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateParameterUri
Uri para o arquivo de parâmetro do modelo.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateSpecId
ID do recurso do templateSpec a ser implantado.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateUri
Uri para o arquivo de modelo.
Tipo: | String |
Position: | Named |
valor padrão: | None |
Obrigatório: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Tipo: | SwitchParameter |
Aliases: | wi |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIfExcludeChangeType
Tipos de alteração de recursos separados por vírgulas a serem excluídos dos resultados de hipóteses. Aplicável quando a opção -WhatIf ou -Confirm está definida.
Tipo: | String[] |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIfResultFormat
O formato de resultado hipotético. Aplicável quando a opção -WhatIf ou -Confirm está definida.
Tipo: | WhatIfResultFormat |
valores aceitos: | ResourceIdOnly, FullResourcePayloads |
Position: | Named |
valor padrão: | None |
Obrigatório: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |