Получает политики выполнения для текущего сеанса.
Синтаксис
Get-ExecutionPolicy [[-Scope] {<Process> | <CurrentUser> | <LocalMachine> | <UserPolicy> | <MachinePolicy>}] [-List] [<CommonParameters>]
Описание
Командлет Get-ExecutionPolicy получает политики выполнения для текущего сеанса.
Политика выполнения определяется политиками выполнения, которые задаются с помощью командлета Set-ExecutionPolicy и параметров групповой политики для политики выполнения Windows PowerShell. По умолчанию используется значение "Restricted".
Без указания параметров Get-ExecutionPolicy получает политику выполнения, действующую в сеансе. С помощью параметра List можно получить все политики выполнения, влияющие на сеанс, а с помощью параметра Scope можно получить политику выполнения для определенной области.
Дополнительные сведения см. в разделе about_Execution_Policies.
Параметры
-List
Получает все значения политики выполнения для сеанса, указанного в порядке приоритета. По умолчанию Get-ExecutionPolicy получает только действующую политику выполнения.
|
Обязательно? |
false |
|
Позиция? |
named |
|
Значение по умолчанию |
False |
|
Принимать входные данные из конвейера? |
false |
|
Принимать подстановочные знаки? |
false |
-Scope <ExecutionPolicyScope>
Получает политику выполнения в указанной области. По умолчанию Get-ExecutionPolicy получает действующую политику выполнения для текущего сеанса.
Допустимые значения:
MachinePolicy: политика выполнения, заданная групповой политикой для всех пользователей компьютера.
UserPolicy: политика выполнения, заданная групповой политикой для текущего пользователя компьютера.
Process: политика выполнения, заданная для текущего процесса Windows PowerShell.
CurrentUser: политика выполнения, заданная для текущего пользователя.
LocalMachine: политика выполнения, заданная для всех пользователей компьютера.
|
Обязательно? |
false |
|
Позиция? |
1 |
|
Значение по умолчанию |
Effective execution policy |
|
Принимать входные данные из конвейера? |
true (ByPropertyName) |
|
Принимать подстановочные знаки? |
false |
<CommonParameters>
Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.
Ввод и вывод
Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.
|
Входные данные |
None Передать входные данные этому командлету по конвейеру невозможно. |
|
Выходные данные |
Microsoft.PowerShell.ExecutionPolicy Get-ExecutionPolicy возвращает объект для каждой получаемой политики выполнения. |
Примечания
Командлет Get-ExecutionPolicy нельзя использовать для получения конкретных политик выполнения, настроенных для конкретной области, или для получения политики выполнения, настроенной с помощью групповой политики. Командлет Get-ExecutionPolicy позволяет получать только действующую политику выполнения, составленную из всех правил приоритета.
Политика выполнения — часть стратегии безопасности оболочки Windows PowerShell. Она определяет, можно ли загружать файлы конфигурации (в том числе профиль Windows PowerShell) и выполнять скрипты, и определяет, для выполнения каких скриптов, если такие имеются, требуется цифровая подпись.
Действующая политика выполнения определяется политиками, заданными с помощью командлета Set-ExecutionPolicy и групповых политик "Включить выполнение скриптов" для компьютеров и пользователей. Очередность выполнения: групповая политика компьютера > групповая политика пользователя > политика выполнения процесса (сеанса) > политика выполнения пользователя > политика выполнения компьютера.
Чтобы получить дополнительные сведения о политике выполнения Windows PowerShell, в том числе определения политик Windows PowerShell, см. раздел about_Execution_Policies.
Пример 1
C:\PS>get-executionpolicy Restricted Описание ----------- Эта команда получает текущую политику выполнения для оболочки.
Пример 2
C:\PS>set-executionpolicy RemoteSigned; get-executionPolicy RemoteSigned Описание ----------- Эти команды задают новую настройку пользователя для политики выполнения оболочки, а затем отображают действующую политику выполнения. Команды разделены точкой с запятой (;). В этом примере из-за отсутствия параметра групповой политики, действующей политикой для оболочки являются пользовательские настройки.
Пример 3
C:\PS>get-executionpolicy -list
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser AllSigned
LocalMachine RemoteSigned
C:\PS> get-executionpolicy
AllSigned
Описание
-----------
Эти команды получают все политики выполнения в текущем сеансе и действующую политику выполнения.
Первая команда получает все политики выполнения, влияющие на текущий сеанс. Ниже они указаны в порядке приоритета.
Вторая команда получает только действующую политику выполнения, которая задана в области CurrentUser.
См. также