New-AzureRmTag
Cria uma marca predefinida do Azure ou adiciona valores a uma marca existente.
Aviso
O módulo do PowerShell do AzureRM foi oficialmente preterido em 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.
Syntax
New-AzureRmTag
[-Name] <String>
[[-Value] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
O cmdlet New-AzureRmTag cria uma marca predefinida do Azure com um valor predefinido opcional. Você também pode usá-lo para adicionar valores adicionais a marcas 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. Esse 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 procurar 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 de departamento predefinida com um valor para cada departamento, como Finanças, Recursos Humanos e TI. Ao aplicar a marca Department a um recurso, você aplica apenas um valor predefinido, como Finance.
Exemplos
Exemplo 1: Criar uma tag predefinida
PS C:\>New-AzureRmTag -Name "FY2015"
Name: FY2015
Count: 0
Values:
Name Count
========= =====
Finance 0Esse comando cria uma tag predefinida chamada FY2015. Essa tag não tem valores. Você pode aplicar uma marca sem valores a um recurso ou grupo de recursos ou usar New-AzureRmTag para adicionar valores à marca. Você também pode especificar um valor ao aplicar a marca 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 0Esse 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 0Esses comandos criam uma tag predefinida chamada Department com dois valores. Se o nome da marca existir, New-AzureRmTag adicionará o valor à marca existente em vez de criar uma nova.
Exemplo 4: Usar uma marca 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 0001Os comandos neste exemplo criam e usam uma marca predefinida.
Parâmetros
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica o nome da marca. Para criar uma nova marca predefinida, insira um nome exclusivo. Para adicionar um valor a uma marca existente, insira o nome da marca existente. Se uma marca predefinida existente tiver o nome especificado, New-AzureRmTag adicionará o valor especificado, se houver, à marca com esse nome em vez de criar uma nova marca.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Value
Especifica um valor de marca. As tags predefinidas podem ter vários valores, mas você pode inserir apenas um valor em cada comando. Esse parâmetro é opcional, pois as tags podem ter nomes sem valores.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |