Partilhar via

New-AzTemplateSpec

  • Referência
Módulo:
Az.Resources

Cria uma nova especificação de modelo.

Sintaxe

New-AzTemplateSpec
   [-ResourceGroupName] <String>
   [-Name] <String>
   -Version <String>
   [-Description <String>]
   [-DisplayName <String>]
   [-Location <String>]
   [-Tag <Hashtable>]
   -TemplateJson <String>
   [-VersionDescription <String>]
   [-Force]
   [-UIFormDefinitionFile <String>]
   [-UIFormDefinitionString <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzTemplateSpec
   [-ResourceGroupName] <String>
   [-Name] <String>
   -Version <String>
   [-Description <String>]
   [-DisplayName <String>]
   [-Location <String>]
   [-Tag <Hashtable>]
   -TemplateFile <String>
   [-VersionDescription <String>]
   [-Force]
   [-UIFormDefinitionFile <String>]
   [-UIFormDefinitionString <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cria uma nova versão de especificação de modelo com o conteúdo de modelo ARM especificado. O conteúdo pode vir de uma cadeia de caracteres JSON bruta (usando o conjunto de parâmetros FromJsonStringParameterSet ) ou de um arquivo JSON/Bicep especificado (usando o conjunto de parâmetros FromJsonFileParameterSet ).

Se a Especificação do Modelo raiz ainda não existir, ela será criada junto com a versão Especificação do Modelo. Se já existir uma especificação de modelo com o nome fornecido, ela e a versão especificada serão atualizadas (quaisquer outras versões existentes serão preservadas).

Exemplos

Exemplo 1

$templateJson = @"
{
    "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {},
    "resources": []
}
"@
New-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'myTemplateSpec' -Version 'v1.0' -Location 'West US' -TemplateJson $templateJson

Cria uma nova versão de especificação de modelo "v1.0" em uma especificação de modelo chamada "myTemplateSpec". A versão especificada terá $templateJson como conteúdo do modelo ARM da versão.

Nota: O modelo ARM no exemplo é um no-op, pois não contém recursos reais.

Exemplo 2

New-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'myTemplateSpec' -Version 'v2.0' -Location 'West US' -TemplateFile 'myTemplateContent.json'

Cria uma nova versão de especificação de modelo "v2.0" em uma especificação de modelo chamada "myTemplateSpec". A versão especificada terá o conteúdo do arquivo local "myTemplateContent.json" como conteúdo do modelo ARM da versão.

Parâmetros

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

A descrição da especificação do modelo.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DisplayName

O nome para exibição da especificação do modelo.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Force

Não peça confirmação ao substituir uma versão existente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Location

O local da especificação do modelo. Apenas necessário se a especificação do modelo ainda não existir.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

O nome da especificação do modelo.

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

O nome do grupo de recursos.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Tag

Tabela de hash de tags para o(s) novo(s) recurso(s) de especificação de modelo.

Tipo:Hashtable
Aliases:Tags
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TemplateFile

O caminho do arquivo para o arquivo JSON/Bicep de modelo local do Azure Resource Manager.

Tipo:String
Aliases:InputFile
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TemplateJson

O modelo do Azure Resource Manager JSON.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-UIFormDefinitionFile

UIForm para o recurso templatespec

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-UIFormDefinitionString

UIForm para o recurso templatespec

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Version

A versão da especificação do modelo.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VersionDescription

A descrição da versão.

Tipo:String
Position:Named
Default value:None
Necessário:False
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:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Saídas

PSTemplateSpec