Get-AipServiceTemplateProperty
Возвращает свойства шаблона защиты для Azure Information Protection.
Синтаксис
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
Возвращает параметр конфигурации срока действия содержимого для содержимого, защищенного шаблоном.
Возвращается одно из следующих значений:
никогда не. Указывает, что содержимое доступно на неопределенный срок.
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 |