Set-AzResourceGroup

Módulo:
Az.Resources Module

Modifica um grupo de recursos.

Sintaxe

SetByResourceGroupName (Predefinição) 

Set-AzResourceGroup
    [-Tag] <Hashtable>
    -Name <String>
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

SetByResourceGroupId 

Set-AzResourceGroup
    [-Tag] <Hashtable>
    -Id <String>
    [-ApiVersion <String>]
    [-Pre]
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Descrição

O cmdlet Set-AzResourceGroup modifica as propriedades de um grupo de recursos. Pode usar este cmdlet para adicionar, alterar ou eliminar as etiquetas 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 tags. Não é possível 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"}

Este comando aplica uma tag Department com um valor de IT a um grupo de recursos que não tem tags existentes.

Exemplo 2: Adicionar tags 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 Status com um valor Approved e uma tag FY2016 a um grupo de recursos que tem tags existentes. Como as tags especificadas substituem as tags existentes, você deve incluir as tags existentes na nova coleção de tags ou as perderá. O primeiro comando obtém o grupo de recursos ContosoRG e usa o método dot para obter o valor de sua propriedade Tags. O comando armazena as tags na variável $Tags. O segundo comando obtém as tags na variável $Tags. O terceiro comando usa o operador de atribuição += para adicionar as tags Status e FY2016 à matriz de tags 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 tag Department e as duas novas tags, Status e FY2015.

Exemplo 3: Excluir todas as tags 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

-AcquirePolicyToken

Adquira automaticamente um token Azure Policy para esta operação de recurso.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ApiVersion

Especifica a versão da API suportada pelo provedor de recursos. Você pode especificar uma versão diferente da versão padrão.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ChangeReference

A alteração do ID de referência do recurso para esta operação de recurso.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Id

Especifica a ID do grupo de recursos a ser modificado.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Id do Grupo de Recursos, ResourceId

Conjuntos de parâmetros

SetByResourceGroupId
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome do grupo de recursos a ser modificado.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ResourceGroupName

Conjuntos de parâmetros

SetByResourceGroupName
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Pre

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Tag

Pares chave-valor na forma de uma tabela de hash. Por exemplo: @{key0="value0"; chave1=$null; key2="value2"} Uma tag é um par nome-valor que você pode criar e aplicar a recursos e grupos de recursos. Depois de atribuir tags a recursos e grupos, você pode usar o parâmetro Tag de Get-AzResource e Get-AzResourceGroup para pesquisar recursos e grupos por nome de marca ou nome e valor. Você pode usar tags para categorizar seus recursos, como por departamento ou centro de custo, ou para acompanhar anotações ou comentários sobre os recursos. Para adicionar ou alterar uma etiqueta, tem de substituir a coleção de etiquetas para o grupo de recursos. Para excluir uma tag, insira uma tabela de hash com todas as tags atualmente aplicadas ao grupo de recursos, de Get-AzResourceGroup, exceto a tag que você deseja excluir. Para excluir todas as tags de um grupo de recursos, especifique uma tabela de hash vazia: @{}.

Propriedades dos parâmetros

Tipo:Hashtable
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Etiquetas

Conjuntos de parâmetros

(All)
Posto:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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

Hashtable

Saídas

PSResourceGroup