New-AzureRmTag
Cria uma marca predefinida do Azure ou adiciona valores a uma marca existente.
Aviso
O módulo AzureRM PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.
Sintaxe
New-AzureRmTag
[-Name] <String>
[[-Value] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet New-AzureRmTag cria uma marca do Azure predefinida com um valor predefinido opcional. Você também pode usá-lo para adicionar valores adicionais a tags predefinidas existentes. Para criar uma tag predefinida, insira um nome de tag exclusivo. Para adicionar um valor a uma tag predefinida existente, especifique o nome da tag existente e o novo valor. Este cmdlet retorna um objeto que representa a marca nova ou modificada com seus valores e o número de recursos aos quais ela foi aplicada. O módulo Marcas do Azure do qual New-AzureRmTag faz parte pode ajudá-lo a gerenciar marcas predefinidas do Azure. Uma marca do Azure é um par nome-valor que você pode usar para categorizar seus recursos e grupos de recursos do Azure, como por departamento ou centro de custo, ou para controlar anotações ou comentários sobre os recursos e grupos. Você pode definir e aplicar tags em uma única etapa, mas as tags predefinidas permitem estabelecer nomes e valores padrão, consistentes e previsíveis para as tags em sua assinatura. Para aplicar uma marca predefinida a um recurso ou grupo de recursos, use o parâmetro Tag do cmdlet New-AzureRmTag. Para pesquisar grupos de recursos com um nome de marca especificado ou nome e valor, use o parâmetro Tag do cmdlet Get-AzureRMResourceGroup. Cada tag tem um nome. Os valores são opcionais. Uma marca predefinida do Azure pode ter vários valores, mas quando você aplica a marca a um recurso ou grupo de recursos, aplica o nome da marca e apenas um de seus valores. Por exemplo, você pode criar uma tag Department predefinida com um valor para cada departamento, como Finanças, Recursos Humanos e TI. Ao aplicar a tag Department a um recurso, você aplica apenas um valor predefinido, como Finanças.
Exemplos
Exemplo 1: Criar uma tag predefinida
PS C:\>New-AzureRmTag -Name "FY2015"
Name: FY2015
Count: 0
Values:
Name Count
========= =====
Finance 0
Este comando cria uma tag predefinida chamada FY2015. Essa tag não tem valores. Você pode aplicar uma tag sem valores a um recurso ou grupo de recursos ou usar New-AzureRmTag para adicionar valores à tag. Você também pode especificar um valor ao aplicar a tag ao recurso ou grupo de recursos.
Exemplo 2: Criar uma tag predefinida com um valor
PS C:\>New-AzureRmTag -Name "Department" -Value "Finance"
Name: Department
Count: 0
Values:
Name Count
========= =====
Finance 0
Este comando cria uma tag predefinida chamada Department com um valor de Finance.
Exemplo 3: Adicionar um valor a uma tag predefinida
PS C:\>New-AzureRmTag -Name "Department" -Value "Finance"
Name: Department
Count: 0
Values:
Name Count
========= =====
Finance 0
PS C:\>New-AzureRmTag -Name "Department" -Value "IT"
Name: Department
Count: 0
Values:
Name Count
========= =====
Finance 0
IT 0
Esses comandos criam uma tag predefinida chamada Department com dois valores. Se o nome da tag existir, New-AzureRmTag adicionará o valor à tag existente em vez de criar uma nova.
Exemplo 4: Usar uma tag predefinida
PS C:\>New-AzureRmTag -Name "CostCenter" -Value "0001"
Name: CostCenter
Count: 0
Values:
Name Count
========= =====
0001 0
PS C:\>Set-AzureRmResourceGroup -Name "EngineerBlog" -Tag @{Name="CostCenter";Value="0001"}
Name: EngineerBlog
Location: East US
Resources:
Name Type Location
=============== ======================= ========
EngineerBlog Microsoft.Web/sites West US
EngSvr01 Microsoft.Sql/servers West US
EngDB02 Microsoft.Sql/databases West US
Tags:
Name Value
========== =====
CostCenter 0001
PS C:\>Get-AzureRmTag -Name "CostCenter"
Name: CostCenter
Count: 1
Values:
Name Count
========= =====
0001 1
PS C:\>Get-AzureRmResourceGroup -Tag @{Name="CostCenter"}
Name: EngineerBlog
Location: East US
Resources:
Name Type Location
=============== ======================= ========
EngineerBlog Microsoft.Web/sites West US
EngSvr01 Microsoft.Sql/servers West US
EngDB02 Microsoft.Sql/databases West US
Tags:
Name Value
========== =====
CostCenter 0001
Os comandos neste exemplo criam e usam uma tag predefinida.
Parâmetros
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Tipo: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Name
Especifica o nome da tag. Para criar uma nova tag predefinida, insira um nome exclusivo. Para adicionar um valor a uma etiqueta existente, introduza o nome da etiqueta existente. Se uma tag predefinida existente tiver o nome especificado, New-AzureRmTag adicionará o valor especificado, se houver, à tag com esse nome em vez de criar uma nova tag.
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-Value
Especifica um valor de tag. As tags predefinidas podem ter vários valores, mas você pode inserir apenas um valor em cada comando. Esse parâmetro é opcional, porque as tags podem ter nomes sem valores.
Tipo: | String |
Position: | 1 |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |