取得目前工作階段的執行原則。

語法

Get-ExecutionPolicy [[-Scope] {<Process> | <CurrentUser> | <LocalMachine> | <UserPolicy> | <MachinePolicy>}] [-List] [<CommonParameters>]

描述

Get-ExecutionPolicy Cmdlet 會取得目前工作階段的執行原則。

執行原則是由您使用 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>

這個 Cmdlet 支援一般參數:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊,請參閱 about_Commonparameters.

輸入和輸出

輸入型別是可經由管道輸出至 Cmdlet 的物件型別。傳回型別則是 Cmdlet 所傳回的物件型別。

輸入

您無法經由管道將輸入輸出至這個 Cmdlet。

輸出

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 範圍中設定的執行原則。






請參閱




目錄