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


New-CustomPermissions

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

Синтаксис

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

Описание

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

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

Примеры

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

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

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

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

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

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

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

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

Параметры

-ExpirationDate

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

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

Тип:DateTime
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Permissions

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

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

Тип:Permissions
Допустимые значения:Viewer, Reviewer, CoAuthor, CoOwner
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Users

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

Тип:String[]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

None

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

System.Object