Set-AzResourceGroup
Modifica um grupo de recursos.
Sintaxe
SetByResourceGroupName (Padrão)
Set-AzResourceGroup
[-Tag] <Hashtable>
-Name <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
SetByResourceGroupId
Set-AzResourceGroup
[-Tag] <Hashtable>
-Id <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Set-AzResourceGroup modifica as propriedades de um grupo de recursos. Você pode usar esse cmdlet para adicionar, alterar ou excluir as marcas do Azure aplicadas a um grupo de recursos. Especifique o parâmetro Name para identificar o grupo de recursos e o parâmetro Tag para modificar as marcas. Você não pode usar esse cmdlet para alterar o nome de um grupo de recursos.
Exemplos
Exemplo 1: aplicar uma marca a um grupo de recursos
Set-AzResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}
Esse comando aplica uma marca de departamento com um valor de TI a um grupo de recursos que não tem marcas existentes.
Exemplo 2: Adicionar marcas a um grupo de recursos
$Tags = (Get-AzResourceGroup -Name "ContosoRG").Tags
$Tags
$Tags += @{"Status"="Approved"; "FY2016"=$null}
Set-AzResourceGroup -Name "ContosoRG" -Tag $Tags
(Get-AzResourceGroup -Name "ContosoRG").Tags
Este exemplo adiciona uma marca de status com um valor de Approved e uma marca FY2016 a um grupo de recursos que tem marcas existentes. Como as marcas especificadas substituem as marcas existentes, você deve incluir as marcas existentes na nova coleção de marcas ou perdê-las. O primeiro comando obtém o grupo de recursos ContosoRG e usa o método ponto para obter o valor de sua propriedade Tags. O comando armazena as marcas na variável $Tags. O segundo comando obtém as marcas na variável $Tags. O terceiro comando usa o operador de atribuição += para adicionar as marcas Status e FY2016 à matriz de marcas na variável $Tags. O quarto comando usa o parâmetro Tag de Set-AzResourceGroup para aplicar as marcas na variável $Tags ao grupo de recursos ContosoRG. O quinto comando obtém todas as marcas aplicadas ao grupo de recursos ContosoRG. A saída mostra que o grupo de recursos tem a marca Departamento e as duas novas marcas, Status e FY2015.
Exemplo 3: excluir todas as marcas de um grupo de recursos
Set-AzResourceGroup -Name "ContosoRG" -Tag @{}
Este comando especifica o parâmetro Tag com um valor de tabela de hash vazio para excluir todas as marcas do grupo de recursos ContosoRG.
Parâmetros
-ApiVersion
Especifica a versão da API com suporte do provedor de recursos. Você pode especificar uma versão diferente da versão padrão.
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 |
-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 |
-Id
Especifica a ID do grupo de recursos a ser modificado.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | ResourceGroupId, ResourceId |
Conjuntos de parâmetros
SetByResourceGroupId
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Especifica o nome do grupo de recursos a ser modificado.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | NomeDoGrupoDeRecursos |
Conjuntos de parâmetros
SetByResourceGroupName
| Cargo: | Named |
| Obrigatório: | True |
| 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 |
-Tag
Pares chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; key1=$null; key2="value2"} Uma marca é um par nome-valor que você pode criar e aplicar a recursos e grupos de recursos. Depois de atribuir marcas a recursos e grupos, você pode usar o parâmetro Tag de Get-AzResource e Get-AzResourceGroup para pesquisar recursos e grupos por nome ou nome e valor da marca. Você pode usar marcas para categorizar seus recursos, como por departamento ou centro de custos, ou para acompanhar anotações ou comentários sobre os recursos.
Para adicionar ou alterar uma marca, você deve substituir a coleção de marcas para o grupo de recursos. Para excluir uma marca, insira uma tabela de hash com todas as marcas atualmente aplicadas ao grupo de recursos, de Get-AzResourceGroup, exceto pela marca que você deseja excluir. Para excluir todas as marcas de um grupo de recursos, especifique uma tabela de hash vazia: @{}.
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: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| 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.
