Поделиться через

Get-AipServiceTemplateProperty

  • Ссылка
Модуль:
AIPService

Возвращает свойства шаблона защиты для Information Protection Azure.

Синтаксис

Get-AipServiceTemplateProperty
   -TemplateId <Guid>
   [-Names]
   [-Descriptions]
   [-RightsDefinitions]
   [-ContentExpirationOption]
   [-ContentExpirationDate]
   [-ContentValidityDuration]
   [-LicenseValidityDuration]
   [-ReadOnly]
   [-Status]
   [-ScopedIdentities]
   [-EnableInLegacyApps]
   [<CommonParameters>]

Описание

Командлет Get-AipServiceTemplateProperty получает указанные свойства шаблона защиты для Azure Information Protection с помощью параметра TemplateId.

Аналогичные сведения о конфигурации также можно просмотреть в портал Azure, но этот командлет также содержит GUID шаблона.

Вы можете запросить свойства шаблона по умолчанию или пользовательского шаблона. Дополнительные сведения о пользовательских шаблонах, включая настройку их в портал Azure, см. в статье "Настройка шаблонов и управление ими для Azure Information Protection".

Использование клиента унифицированных меток Azure Information Protection?

Клиент унифицированных меток Azure Information Protection косвенно использует шаблоны защиты. Если у вас есть клиент унифицированных меток, рекомендуется использовать командлеты на основе меток вместо непосредственного изменения шаблонов защиты.

Дополнительные сведения см. в разделе "Создание и публикация меток конфиденциальности " в документации по Microsoft 365.

Примеры

Пример 1. Получение описания и прав на использование шаблона

PS C:\>Get-AipServiceTemplateProperty -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428 -Descriptions -RightsDefinitions

Эта команда получает описание и права на использование для всех пользователей или групп, настроенных для указанного шаблона защиты.

Пример 2. Для всех шаблонов получите имя, права на использование, тип шаблона по умолчанию и публикацию или архивирование.

PS C:\>$templates = Get-AipServiceTemplate PS C:\>foreach ($template in $templates) {Get-AipServiceTemplateProperty -TemplateId $template.TemplateId -Name -RightsDefinitions -ReadOnly -Status}

Первая команда получает все идентификаторы шаблонов и сохраняет их в переменной. Затем вторая команда использует эту переменную для получения имени шаблона, прав на использование, только для чтения (true для шаблона по умолчанию, false для настраиваемого шаблона) и состояния (опубликовано или архивировано) для каждого шаблона.

Параметры

-ContentExpirationDate

Отображает дату истечения срока действия содержимого, защищенного с помощью шаблона.

Используйте этот параметр, только если для ContentExpirationOption задано значение OnDate.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentExpirationOption

Возвращает параметр конфигурации срока действия содержимого для содержимого, защищенного с помощью шаблона.

Возвращается одно из следующих значений.

  • Never. Указывает, что контент доступен бессрочно.

  • OnDate. Указывает, что срок действия контента истекает в определенную дату.

  • AfterDays. Указывает, что контент доступен в течение заданного количества дней после начала защиты.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentValidityDuration

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

Используйте этот параметр, только если для ContentExpirationOption задано значение AfterDays.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Descriptions

Список описаний шаблона во всех языковых стандартах.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableInLegacyApps

Указывает поведение шаблона отдела в приложениях, которые не поддерживают шаблоны отделов (см. параметр ScopedIdentities ).

Если задано значение True и шаблон является шаблоном отдела, все пользователи, пытающиеся защитить содержимое от приложения, не поддерживающего шаблоны отделов, увидят шаблон и, следовательно, смогут выбрать его независимо от того, являются ли пользователи членами целевой области шаблона.

Если задано значение False, пользователи не видят и поэтому не могут выбрать шаблон в приложениях, которые не поддерживают шаблоны отделов, даже если пользователи являются членами целевой области шаблона.

Этот параметр не влияет на шаблоны, которые не являются шаблонами отдела, а также не влияет на приложения со встроенной поддержкой шаблонов отделов.

Этот параметр функционально эквивалентен показанию этого шаблона всем пользователям, если приложения не поддерживают удостоверение пользователя при настройке совместимости приложений на классическом портале Azure (теперь прекращено). В портал Azure нет эквивалентного параметра.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LicenseValidityDuration

Выводит список дней, в течение которых содержимое доступно в автономном режиме после получения лицензии.

-1 указывает неограниченный доступ.

0 указывает, что лицензия должна быть получена для каждого использования и что содержимое доступно только в Интернете.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Names

Перечисляет имена шаблона во всех языковых стандартах.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReadOnly

Указывает, является ли шаблон шаблоном по умолчанию (True) и поэтому не может быть изменен или удален, или настраиваемый шаблон (False) и поэтому может быть изменен или удален администратором.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RightsDefinitions

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScopedIdentities

Указывает пользователей по электронным адресам (учетным записям или группам), которые могут видеть и выбирать шаблоны отделов в приложениях.

Чтобы указанные пользователи могли видеть шаблоны, приложение должно поддерживать шаблоны отделов или параметр EnableInLegacyApps должен иметь значение True.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Status

Состояние шаблона:

-Архивные шаблоны доступны для использования ранее защищенного содержимого, но не отображаются пользователям.

-Опубликованные шаблоны доступны пользователям для защиты содержимого.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TemplateId

Указывает GUID шаблона защиты.

Командлет Get-AipServiceTemplate можно использовать для получения идентификатора шаблона всех шаблонов.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False