Get-RetentionPolicyTag
Этот командлет доступен в локальной среде 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.