New-AIPCustomPermissions

Релевантный для: Только клиент унифицированных меток AIP

Создает специальную политику защиты для пользовательских разрешений.

Синтаксис

New-AIPCustomPermissions
   -Users <String[]>
   -Permissions <Permissions>
   [-ExpirationDate <DateTime>]
   [<CommonParameters>]

Описание

Командлет New-AIPCustomPermissions создает объект политики нерегламентированной защиты для пользовательских разрешений, которые хранятся в виде переменной, а затем используются для защиты файла или файлов при выполнении командлета маркировки Set-AIPFileLabel.

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

Примеры

Пример 1. Создание объекта политики нерегламентированной защиты для одного пользователя

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com -Permissions Viewer

Эта команда создает объект политики нерегламентированной защиты, который предоставляет user1 из contoso.com прав на использование из разрешений рецензента и сохраняет эту политику в переменной именованных разрешений. Эта нерегламентированная политика защиты может использоваться для применения защиты к файлу или файлам.

Выходные данные для этой команды не отображаются.

Пример 2. Создание объекта политики нерегламентированной защиты для нескольких пользователей и даты окончания срока действия

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)

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

Выходные данные для этой команды не отображаются.

Параметры

-ExpirationDate

Указывает дату окончания срока действия для нерегламентированной политики защиты.

После этой даты окончания срока действия указанные пользователи больше не смогут получить доступ к файлу или файлам. Однако владелец и суперпользовай всегда могут получить доступ к файлу даже после достижения истечения срока действия.

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

-Permissions

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

Чтобы узнать, какие права на использование включены в каждый из уровней разрешений, см. раздел "Права", включенные в уровни разрешений.

Type:Permissions
Accepted values:Viewer, Reviewer, CoAuthor, CoOwner
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Users

Указывает пользователей, у которых есть права на использование файла или файлов. Используйте этот параметр и параметр Permission для предоставления прав указанным пользователям или группам.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

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

None

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

System.Object