本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 给你的目录加标签
<a name="tag_directory"></a>

标签是键值对，您可以将其分配给 Amazon Directory Service 目录，以帮助您组织和管理资源。您可以使用标签按用途、环境、成本分配和其他标准对目录进行分类。每个标签都包含一个必需的标签键和一个可选的标签值。每个目录的标签密钥必须是唯一的。

有关标记策略的更多信息，请参阅[标记最佳](https://docs.amazonaws.cn/whitepapers/latest/tagging-best-practices/tagging-best-practices.html)实践。

您可以从中运行以下命令 [Amazon CloudShell](https://docs.amazonaws.cn/cloudshell/latest/userguide/welcome.html)，这些命令附带了 Amazon CLIPowerShell、和，[AWS.Tools 用于PowerShell](https://www.amazonaws.cn/powershell/)预安装，并且会自动配置凭据。

1. 登录到 Amazon Web Services 管理控制台。

1. 打开 [Amazon CloudShell](https://console.amazonaws.cn/cloudshell/home)。运行`pwsh`以使用PowerShell命令。

## 向您的目录添加标签
<a name="tag_directory_add"></a>

您可以使用 Amazon CLI 或将标签添加到您的目录中PowerShell：

------
#### [ Amazon CLI ]

**要将标签添加到您的目录中，请使用 Amazon CLI**
+ 打开 Amazon CLI. 运行以下命令，将目录 ID 和标签值替换为您自己的值：

  ```
  aws ds add-tags-to-resource \
    --resource-id {{d-1234567890}} \
    --tags Key={{MyTagName1}},Value={{MyTagValue1}} \
           Key={{MyTagName2}},Value={{MyTagValue2}}
  ```

  有关更多信息，请参阅 [https://docs.amazonaws.cn/cli/latest/reference/ds/add-tags-to-resource.html](https://docs.amazonaws.cn/cli/latest/reference/ds/add-tags-to-resource.html)。

------
#### [ PowerShell ]

**要向目录添加标签，请使用 PowerShell**
+ 打开 PowerShell。运行以下命令，将目录 ID 和标签值替换为您自己的值：

  ```
  Add-DSResourceTag `
    -ResourceId {{d-1234567890}} `
    -Tag @{Key="{{MyTagName1}}"; Value="{{MyTagValue1}}"}, `
         @{Key="{{MyTagName2}}"; Value="{{MyTagValue2}}"}
  ```

  有关更多信息，请参阅 [https://docs.amazonaws.cn//powershell/latest/reference/items/Add-DSResourceTag.html](https://docs.amazonaws.cn//powershell/latest/reference/items/Add-DSResourceTag.html)。

------

## 列出目录上的标签
<a name="tag_directory_list"></a>

您可以使用 Amazon CLI 或列出目录中的现有标签PowerShell：

------
#### [ Amazon CLI ]

**使用列出目录中的标签 Amazon CLI**
+ 打开 Amazon CLI. 运行以下命令，将目录 ID 替换为自己的目录 ID：

  ```
  aws ds list-tags-for-resource \
    --resource-id {{d-1234567890}}
  ```

  有关更多信息，请参阅 [https://docs.amazonaws.cn/cli/latest/reference/ds/list-tags-for-resource.html](https://docs.amazonaws.cn/cli/latest/reference/ds/list-tags-for-resource.html)。

------
#### [ PowerShell ]

**要列出目录上的标签，请使用 PowerShell**
+ 打开 PowerShell。运行以下命令，将目录 ID 替换为自己的目录 ID：

  ```
  Get-DSResourceTag `
    -ResourceId {{d-1234567890}}
  ```

  有关更多信息，请参阅 [https://docs.amazonaws.cn//powershell/latest/reference/items/Get-DSResourceTag.html](https://docs.amazonaws.cn//powershell/latest/reference/items/Get-DSResourceTag.html)。

------

## 更新目录上的标签
<a name="tag_directory_update"></a>

要更新现有标签的值，请使用具有现有密钥名称和新值的相同添加命令。这会覆盖先前的值。

------
#### [ Amazon CLI ]

**要使用更新目录上的标签 Amazon CLI**
+ 打开 Amazon CLI. 运行以下命令，用您自己的目录 ID、标签键和新值替换目录 ID、标签键和新值：

  ```
  aws ds add-tags-to-resource \
    --resource-id {{d-1234567890}} \
    --tags Key={{MyTagName1}},Value={{MyNewTagValue1}}
  ```

  有关更多信息，请参阅 [https://docs.amazonaws.cn/cli/latest/reference/ds/add-tags-to-resource.html](https://docs.amazonaws.cn/cli/latest/reference/ds/add-tags-to-resource.html)。

------
#### [ PowerShell ]

**使用更新目录上的标签 PowerShell**
+ 打开 PowerShell。运行以下命令，用您自己的目录 ID、标签键和新值替换目录 ID、标签键和新值：

  ```
  Add-DSResourceTag `
    -ResourceId {{d-1234567890}} `
    -Tag @{Key="{{MyTagName1}}"; Value="{{MyNewTagValue1}}"}
  ```

  有关更多信息，请参阅 [https://docs.amazonaws.cn//powershell/latest/reference/items/Add-DSResourceTag.html](https://docs.amazonaws.cn//powershell/latest/reference/items/Add-DSResourceTag.html)。

------

## 从目录中移除标签
<a name="tag_directory_remove"></a>

您可以使用 Amazon CLI 或从目录中移除标签PowerShell：

------
#### [ Amazon CLI ]

**要从目录中删除标签，请使用 Amazon CLI**
+ 打开 Amazon CLI. 运行以下命令，将目录 ID 和标签密钥名称替换为您自己的名称：

  ```
  aws ds remove-tags-from-resource \
    --resource-id {{d-1234567890}} \
    --tag-keys {{MyTagName1}} {{MyTagName2}}
  ```

  有关更多信息，请参阅 [https://docs.amazonaws.cn/cli/latest/reference/ds/remove-tags-from-resource.html](https://docs.amazonaws.cn/cli/latest/reference/ds/remove-tags-from-resource.html)。

------
#### [ PowerShell ]

**要从目录中移除标签，请使用 PowerShell**
+ 打开 PowerShell。运行以下命令，将目录 ID 和标签密钥名称替换为您自己的名称：

  ```
  Remove-DSResourceTag `
    -ResourceId {{d-1234567890}} `
    -TagKey "{{MyTagName1}}", `
            "{{MyTagName2}}" `
    -Force
  ```

  有关更多信息，请参阅 [https://docs.amazonaws.cn//powershell/latest/reference/items/Remove-DSResourceTag.html](https://docs.amazonaws.cn//powershell/latest/reference/items/Remove-DSResourceTag.html)。

------