Изменяет дескриптор безопасности указанного ресурса, например файла или раздела реестра.
Синтаксис
Set-Acl [-Path] <string[]> [-AclObject] <ObjectSecurity> [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Описание
Командлет Set-Acl изменяет дескриптор безопасности указанного ресурса, такого как файл или раздел реестра, в соответствии со значением предоставленного дескриптором безопасности.
Чтобы использовать командлет Set-Acl, воспользуйтесь параметром Path для определения ресурса, дескриптор безопасности которого нужно изменить, и используйте параметр AclObject, чтобы предоставить дескриптор безопасности со значениями, которые нужно применить. Командлет Set-Acl использует значение параметра как образец и изменяет значения в дескрипторе безопасности ресурса в соответствии со значениями в параметре AclObject.
Параметры
-AclObject <ObjectSecurity>
Задает список управления доступом с заданными значениями свойств. Командлет Set-Acl изменяет список управления доступом ресурса, заданного параметром Path, в соответствии со значениями в указанном объекте безопасности.
Вывод командлета Get-Acl можно сохранить в переменной, а затем использовать параметр AclObject, чтобы передать переменную, или ввести команду Get-Acl.
|
Обязательно? |
true |
|
Позиция? |
2 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByValue) |
|
Принимать подстановочные знаки? |
false |
-Exclude <string[]>
Исключает указанные элементы. Значение этого параметра определяет значение параметра Path. Введите элемент пути или шаблон, например "*.txt". Подстановочные знаки разрешены.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Filter <string>
Задает фильтр с использованием формата или языка поставщика. Значение этого параметра определяет значение параметра Path. Синтаксис фильтра, в том числе использование подстановочных знаков, зависит от поставщика. Фильтры эффективнее других параметров, потому что поставщик применяет их при извлечении объектов (вместо использования Windows PowerShell для фильтрации извлеченных объектов).
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Include <string[]>
Изменяет только указанные элементы. Значение этого параметра определяет значение параметра Path. Введите элемент пути или шаблон, например "*.txt". Подстановочные знаки разрешены.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-PassThru
Возвращает объект, представляющий дескриптор безопасности. По умолчанию этот командлет не формирует никаких выходных данных.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Path <string[]>
Определяет ресурс, дескриптор безопасности которого требуется изменить. Введите путь к ресурсу, например путь к файлу или разделу реестра. Подстановочные знаки разрешены.
Если объект безопасности передается командлету Set-Acl (с помощью параметра AclObject или путем передачи объекта из Get-Acl и Set-Acl) и параметр Path пропущен (имя и значение), то командлет Set-Acl использует путь, включенный в объект безопасности.
|
Обязательно? |
true |
|
Позиция? |
1 |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
-Confirm
Запрашивает подтверждение перед выполнением команды.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-WhatIf
Описывает, что произойдет при выполнении команды, без ее фактического выполнения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-UseTransaction
Включает команду в активную транзакцию. Этот параметр допустим, только если транзакция выполняется. Дополнительные сведения см. в разделе about_Transactions.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
|
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
System.Security.AccessControl.ObjectSecurity Дескриптор безопасности можно передать командлету Set-Acl по конвейеру. |
|
Выходные данные |
Отсутствует или объект безопасности По умолчанию командлет Set-Acl не формирует никаких выходных данных. Однако если использовать параметр "-Passthru", он создает объект безопасности. Тип объекта безопасности зависит от типа ресурса. |
Примечания
Командлет Set-Acl поддерживается поставщиками файловой системы и реестра Windows PowerShell. Поэтому ее можно использовать для изменения дескрипторов безопасности файлов, каталогов и разделов реестра.
При указании нескольких значений параметра разделяйте их запятыми. Например: "<имя-параметра> <значение1>, <значение2>".
Пример 1
C:\PS>$DogACL = get-acl c:\dog.txt C:\PS>set-acl -path C:\cat.txt -AclObject $DogACL Описание ----------- Эти команды копируют значения из дескриптора безопасности файла Dog.txt в дескриптор безопасности файла Cat.txt. После завершения работы команд дескрипторы безопасности файлов Dog.txt и Cat.txt идентичны. В первой команде используется командлет Get-Acl, чтобы получить дескриптор безопасности файла Dog.txt. Оператор назначения (=) сохраняет дескриптор безопасности в качестве значения переменной $DogACL. Вторая команда использует Set-Acl, чтобы изменить значения списка ACL файла Cat.txt на значения из переменной $DogACL. Значение параметра Path представляет собой путь к файлу Cat.txt. Значение параметра AclObject — образец списка ACL, в данном случае список ACL файла Dog.txt, как он был сохранен в переменной $DogACL.
Пример 2
C:\PS>get-acl c:\dog.txt | set-acl -path C:\cat.txt Описание ----------- Эта команда почти такая же, как команда в предыдущем примере, за исключением того, что в ней используется оператор конвейера для передачи дескриптора безопасности, извлеченного в команде Get-Acl, в команду Set-Acl. В первой команде используется командлет Get-Acl, чтобы получить дескриптор безопасности файла Dog.txt. Оператор конвейера (|) передает объект, который представляет дескриптор безопасности файла Dog.txt, в команду Set-Acl. Во второй команде используется командлет Set-Acl, чтобы применить дескриптор безопасности файла Dog.txt к файлу Cat.txt. После завершения работы команды списки ACL файлов Dog.txt и Cat.txt идентичны.
Пример 3
C:\PS>$newACL = get-acl file0.txt C:\PS>get-childitem c:\temp -recurse -include *.txt -force | set-acl -aclobject $newacl Описание ----------- Эти команды применяют дескрипторы безопасности в файле File0.txt ко всем текстовым файлам в каталоге "C:\Temp" и во всех его вложенных каталогах. Первая команда получает дескриптор безопасности файла File0.txt в текущем каталоге и использует оператор назначения (=), чтобы сохранить его в переменной $newACL. Первая команда в конвейере использует командлет Get-ChildItem, чтобы получить все текстовые файлы в каталоге "C:\Temp". Параметр Recurse расширяет действие команды на все вложенные каталоги "C:\temp". Параметр Include ограничивает набор извлеченных файлов файлами с расширением ".txt". Параметр Force позволяет извлечь скрытые файлы, которые в противном случае были бы пропущены. (Нельзя указать "c:\temp\*.txt", так как параметр Recurse применяется к каталогам, а не файлам.) Оператор конвейера (|) передает объекты, представляющие извлеченные файлы, в команду Set-Acl, которая применяет дескриптор безопасности в параметре AclObject ко всем файлам в конвейере. На практике лучше использовать параметр Whatif со всеми командами Set-Acl, которые могут влиять больше, чем на один ресурс. В этом случае второй командой в конвейере будет "set-acl -aclobject $newacl -whatif". Эта команда перечисляет файлы, на которые воздействует команда. После просмотра результатов можно вновь запустить команду без параметра Whatif.
См. также