Set-AzTemplateSpec
Modifica uma especificação de modelo.
Sintaxe
FromJsonStringParameterSet (Default)
Set-AzTemplateSpec
[-Location <String>]
[-Tag <Hashtable>]
[-UIFormDefinitionFile <String>]
[-UIFormDefinitionString <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateByIdParameterSet
Set-AzTemplateSpec
[-ResourceId] <String>
[[-Description] <String>]
[[-DisplayName] <String>]
[-Location <String>]
[-Tag <Hashtable>]
[-UIFormDefinitionFile <String>]
[-UIFormDefinitionString <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateVersionByIdFromJsonFileParameterSet
Set-AzTemplateSpec
[-ResourceId] <String>
[-Version] <String>
[[-Description] <String>]
[[-DisplayName] <String>]
-TemplateFile <String>
[-Location <String>]
[-Tag <Hashtable>]
[-VersionDescription <String>]
[-UIFormDefinitionFile <String>]
[-UIFormDefinitionString <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateVersionByIdFromJsonParameterSet
Set-AzTemplateSpec
[-ResourceId] <String>
[-Version] <String>
[[-Description] <String>]
[[-DisplayName] <String>]
-TemplateJson <String>
[-Location <String>]
[-Tag <Hashtable>]
[-VersionDescription <String>]
[-UIFormDefinitionFile <String>]
[-UIFormDefinitionString <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateByNameParameterSet
Set-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
[[-Description] <String>]
[[-DisplayName] <String>]
[-Location <String>]
[-Tag <Hashtable>]
[-UIFormDefinitionFile <String>]
[-UIFormDefinitionString <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateVersionByNameFromJsonFileParameterSet
Set-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
[-Version] <String>
[[-Description] <String>]
[[-DisplayName] <String>]
-TemplateFile <String>
[-Location <String>]
[-Tag <Hashtable>]
[-VersionDescription <String>]
[-UIFormDefinitionFile <String>]
[-UIFormDefinitionString <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateVersionByNameFromJsonParameterSet
Set-AzTemplateSpec
[-ResourceGroupName] <String>
[-Name] <String>
[-Version] <String>
[[-Description] <String>]
[[-DisplayName] <String>]
-TemplateJson <String>
[-Location <String>]
[-Tag <Hashtable>]
[-VersionDescription <String>]
[-UIFormDefinitionFile <String>]
[-UIFormDefinitionString <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Modifica uma especificação de modelo. Se a Especificação de Modelo com o nome especificado e/ou a versão específica ainda não existir, ela será criada.
Ao modificar o conteúdo do modelo ARM de uma versão de especificação de modelo, o conteúdo pode vir de uma cadeia de caracteres JSON bruta (usando o conjunto de parâmetros UpdateVersionByNameFromJsonParameterSet ) ou de um arquivo JSON/Bicep especificado (usando UpdateVersionByNameFromJsonFileParameterSet definido).
Exemplos
Exemplo 1
$templateJson = @"
{
"$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {},
"resources": []
}
"@
Set-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'myTemplateSpec' -Version 'v1.0' -Location 'West US' -TemplateJson $templateJson
Modifica a versão "v1.0" de uma especificação de modelo chamada "myTemplateSpec". A versão especificada terá $templateJson como o conteúdo do modelo arm da versão. Se a especificação de modelo raiz e/ou a versão ainda não existirem, elas serão criadas.
Anotações:
O modelo arm no exemplo é um no-op, pois não contém recursos reais.
A localização só é necessária quando a Especificação de Modelo ainda não existe
Exemplo 2
Set-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'myTemplateSpec' -Version 'v2.0' -Location 'West US' -TemplateFile 'myTemplateContent.json'
Modifica a versão "v2.0" de uma especificação de modelo chamada "myTemplateSpec". A versão especificada terá o conteúdo do arquivo local "myTemplateContent.json" como o conteúdo do modelo arm da versão. Se a especificação de modelo raiz e/ou a versão ainda não existirem, elas serão criadas.
Nota: A localização só é necessária quando a Especificação de Modelo ainda não existe
Exemplo 3
Set-AzTemplateSpec -ResourceGroupName 'myRG' -Name 'myTemplateSpec' -Location 'West US' -Description 'My updated Template Spec'
Modifica a descrição da Especificação de Modelo chamada "myTemplateSpec" no grupo de recursos "myRG". Se a Especificação de Modelo ainda não existir, ela será criada.
Nota: A localização só é necessária quando a Especificação de Modelo ainda não existe
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None 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 a 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
-Description
A descrição da especificação de modelo.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
UpdateByIdParameterSet
Cargo: 1 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByIdFromJsonFileParameterSet
Cargo: 1 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByIdFromJsonParameterSet
Cargo: 1 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateByNameParameterSet
Cargo: 1 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonFileParameterSet
Cargo: 1 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonParameterSet
Cargo: 1 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-DisplayName
O nome de exibição da especificação de modelo.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
UpdateByIdParameterSet
Cargo: 2 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByIdFromJsonFileParameterSet
Cargo: 2 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByIdFromJsonParameterSet
Cargo: 2 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateByNameParameterSet
Cargo: 2 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonFileParameterSet
Cargo: 2 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonParameterSet
Cargo: 2 Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-Location
O local da especificação do modelo. Necessário somente se a especificação de modelo ainda não existir.
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
-Name
O nome da especificação de modelo.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
UpdateByNameParameterSet
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonFileParameterSet
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonParameterSet
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-ResourceGroupName
O nome do grupo de recursos.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
UpdateByNameParameterSet
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonFileParameterSet
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonParameterSet
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-ResourceId
A ID de recurso totalmente qualificada da especificação de modelo. Exemplo: /subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: ID
Conjuntos de parâmetros
UpdateByIdParameterSet
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByIdFromJsonFileParameterSet
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByIdFromJsonParameterSet
Cargo: 0 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-Tag
Hashtable de marcas para a especificação de modelo e/ou versão
Propriedades do parâmetro
Tipo: Hashtable
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: Etiquetas
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
O caminho do arquivo para o arquivo JSON/Bicep do modelo do Azure Resource Manager local.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: InputFile
Conjuntos de parâmetros
UpdateVersionByIdFromJsonFileParameterSet
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonFileParameterSet
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-TemplateJson
O JSON do modelo do Azure Resource Manager.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
UpdateVersionByIdFromJsonParameterSet
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonParameterSet
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UIForm para o recurso templatespec
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UIForm para o recurso templatespec
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-Version
A versão da especificação de modelo.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
UpdateVersionByIdFromJsonFileParameterSet
Cargo: 3 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByIdFromJsonParameterSet
Cargo: 3 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonFileParameterSet
Cargo: 3 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonParameterSet
Cargo: 3 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
-VersionDescription
A descrição da versão.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
UpdateVersionByIdFromJsonFileParameterSet
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByIdFromJsonParameterSet
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonFileParameterSet
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True Valor dos argumentos restantes: False
UpdateVersionByNameFromJsonParameterSet
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: True 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: None 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
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 .
Saídas
