Get-AipServiceTemplateProperty
Возвращает свойства шаблона защиты для 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.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ContentExpirationOption
Возвращает параметр конфигурации срока действия содержимого для содержимого, защищенного с помощью шаблона.
Возвращается одно из следующих значений.
Never. Указывает, что контент доступен бессрочно.
OnDate. Указывает, что срок действия контента истекает в определенную дату.
AfterDays. Указывает, что контент доступен в течение заданного количества дней после начала защиты.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ContentValidityDuration
Выводит список дней с дня защиты, после которого истекает содержимое, защищенное с помощью шаблона.
Используйте этот параметр, только если для ContentExpirationOption задано значение AfterDays.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Descriptions
Список описаний шаблона во всех языковых стандартах.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-EnableInLegacyApps
Указывает поведение шаблона отдела в приложениях, которые не поддерживают шаблоны отделов (см. параметр ScopedIdentities ).
Если задано значение True и шаблон является шаблоном отдела, все пользователи, пытающиеся защитить содержимое от приложения, не поддерживающего шаблоны отделов, увидят шаблон и, следовательно, смогут выбрать его независимо от того, являются ли пользователи членами целевой области шаблона.
Если задано значение False, пользователи не видят и поэтому не могут выбрать шаблон в приложениях, которые не поддерживают шаблоны отделов, даже если пользователи являются членами целевой области шаблона.
Этот параметр не влияет на шаблоны, которые не являются шаблонами отдела, а также не влияет на приложения со встроенной поддержкой шаблонов отделов.
Этот параметр функционально эквивалентен показанию этого шаблона всем пользователям, если приложения не поддерживают удостоверение пользователя при настройке совместимости приложений на классическом портале Azure (теперь прекращено). В портал Azure нет эквивалентного параметра.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-LicenseValidityDuration
Выводит список дней, в течение которых содержимое доступно в автономном режиме после получения лицензии.
-1 указывает неограниченный доступ.
0 указывает, что лицензия должна быть получена для каждого использования и что содержимое доступно только в Интернете.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Names
Перечисляет имена шаблона во всех языковых стандартах.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ReadOnly
Указывает, является ли шаблон шаблоном по умолчанию (True) и поэтому не может быть изменен или удален, или настраиваемый шаблон (False) и поэтому может быть изменен или удален администратором.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RightsDefinitions
Выводит список прав, предоставленных пользователям или группам для содержимого, защищенного с помощью шаблона.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ScopedIdentities
Указывает пользователей по электронным адресам (учетным записям или группам), которые могут видеть и выбирать шаблоны отделов в приложениях.
Чтобы указанные пользователи могли видеть шаблоны, приложение должно поддерживать шаблоны отделов или параметр EnableInLegacyApps должен иметь значение True.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Status
Состояние шаблона:
- Архивные шаблоны доступны для использования ранее защищенного содержимого, но не отображаются пользователям.
- Опубликованные шаблоны доступны пользователям для защиты содержимого.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-TemplateId
Указывает GUID шаблона защиты.
Командлет Get-AipServiceTemplate можно использовать для получения идентификатора шаблона всех шаблонов.
| Тип: | Guid |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |