Get-RetentionPolicyTag

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Командлет Get-RetentionPolicyTag используется для получения параметров тега хранения.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Get-RetentionPolicyTag
   [[-Identity] <RetentionPolicyTagIdParameter>]
   [-DomainController <Fqdn>]
   [-IncludeSystemTags]
   [-Types <ElcFolderType[]>]
   [<CommonParameters>]
Get-RetentionPolicyTag
   [-Mailbox <MailboxIdParameter>]
   [-OptionalInMailbox]
   [-DomainController <Fqdn>]
   [-IncludeSystemTags]
   [-Types <ElcFolderType[]>]
   [<CommonParameters>]

Описание

Теги хранения позволяют применять параметры хранения сообщений к сообщениям или папкам. Существует три типа тегов хранения:

  • Теги политики хранения
  • Теги политики по умолчанию
  • Личные теги

Теги политики хранения применяются к папкам по умолчанию, например к папкам "Входящие" и "Удаленные". Личные теги позволяют пользователям добавлять тэги к элементам и папкам. Тег политики по умолчанию применяется ко всем элементам, которые не имеют тегов, примененных пользователем, или не унаследованы из папок, в которых расположены. Командлет Get-RetentionPolicyTag отображает все параметры указанного тега.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-RetentionPolicyTag

В этом примере возвращаются все теги хранения.

Пример 2

Get-RetentionPolicyTag -IncludeSystemTags

В этом примере возвращаются системные теги вместе с личными тегами и тегами по умолчанию.

Пример 3

Get-RetentionPolicyTag "Consolidated Messenger"

В этом примере возвращаются параметры тега Consolidated Messenger.

Пример 4

Get-RetentionPolicyTag -Types Inbox,All | Format-Table Name,Type,RetentionEnabled,AgeLimitForRetention,RetentionAction -AutoSize

Этот пример возвращает все теги хранения для папки "Входящие" и "Все" и передает результаты команде Format-Table для отображения свойств Name, Type, RetentionEnabled, AgeLimitForRetention и RetentionAction.

Параметры

-DomainController

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Параметр Identity указывает имя тега.

Type:RetentionPolicyTagIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeSystemTags

Переключатель IncludeSystemTags указывает, нужно ли возвращать какие-либо системные теги. Для этого переключателя не требуется указывать значение.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Mailbox

Параметр Mailbox возвращает теги хранения, назначенные политике хранения, применяемой к указанному почтовому ящику. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя

Этот параметр возвращает только теги политики по умолчанию (DPT) и личные теги; Он не возвращает теги политики хранения.

Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-OptionalInMailbox

Параметр OptionalInMailbox используется вместе с параметром Mailbox для возврата всех тегов хранения согласия, назначенных указанному почтовому ящику. Указывать значение для этого параметра необязательно.

Тег хранения согласия — это личный тег, явно назначенный почтовому ящику с помощью команды Set-RetentionPolicyTag -Mailbox -OptionalInMailbox.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Types

Параметр Types указывает тип возвращаемых тегов хранения. Допустимыми являются следующие значения:

  • Календарь
  • Контакты
  • DeletedItems
  • Черновики
  • Inbox;
  • Нежелательная почта
  • Журнал
  • Примечания.
  • Исходящие
  • SentItems
  • Задачи
  • Все
  • RssSubscriptions
  • ConversationHistory
  • Персональный

Параметр может принимать несколько значений, разделенных запятыми.

Type:ElcFolderType[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.