New-CustomPermissions
Создает специальную политику защиты для пользовательских разрешений.
Синтаксис
Default (По умолчанию)
New-CustomPermissions
-Users <String[]>
-Permissions <Permissions>
[-ExpirationDate <DateTime>]
Описание
Командлет New-CustomPermissions создает специальный объект политики защиты для пользовательских разрешений, который сохраняется в виде переменной, а затем используется для защиты файла или файлов при выполнении командлета маркировки Set-FileLabel.
Если для применяемой метки настроены параметры защиты, настраиваемые разрешения из специальной политики защиты заменяют параметры защиты из метки.
Примеры
Пример 1 — создание объекта специальной политики защиты для одного пользователя
PS C:\> $permissions = New-CustomPermissions -Users user1@contoso.com -Permissions Viewer
Эта команда создает специальный объект политики защиты, который предоставляет пользователю 1 из 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)
Эта команда создает специальный объект политики защиты, который предоставляет пользователям из разных организаций права на использование из разрешений Reviewer, а также применяет дату окончания срока действия. Объект специальной политики защиты хранится в переменной с именем permissions, которую затем можно использовать для применения этой защиты к файлу или файлам.
Выходные данные этой команды не отображаются.
Параметры
-ExpirationDate
Указывает дату окончания срока действия специальной политики защиты.
По истечении этого срока указанные пользователи больше не смогут получить доступ к файлу или файлам. Тем не менее, владелец и суперпользователь всегда могут получить доступ к файлу, даже после истечения срока действия.
Свойства параметров
| Тип: | DateTime |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Permissions
Указывает уровень разрешений, который группирует права использования, которые обычно используются вместе. Используйте этот параметр и параметр Пользователи , чтобы предоставить права использования указанным пользователям.
Чтобы узнать, какие индивидуальные права использования включены в каждый из уровней разрешений, см. раздел Права, включенные в уровни разрешений.
Свойства параметров
| Тип: | Permissions |
| Default value: | None |
| Допустимые значения: | Viewer, Reviewer, CoAuthor, CoOwner |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Users
Указывает пользователей, которые будут иметь права на использование файла или файлов. Используйте этот параметр и параметр Разрешение для предоставления прав указанным пользователям или группам.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |