Get-ExecutionPolicy
Lekéri az aktuális munkamenet végrehajtási szabályzatát.
Syntax
Get-ExecutionPolicy
[[-Scope] <ExecutionPolicyScope>]
[-List]
[<CommonParameters>]
Description
Az egyes hatókörök végrehajtási szabályzatainak az elsőbbségi sorrendben való megjelenítéséhez használja a következőt Get-ExecutionPolicy -List
: . A PowerShell-munkamenet Get-ExecutionPolicy
érvényes végrehajtási szabályzatának megtekintéséhez használja paraméterek nélkül.
A tényleges végrehajtási szabályzatot a csoportházirend beállításai által Set-ExecutionPolicy
beállított végrehajtási szabályzatok határozzák meg.
További információ: about_Execution_Policies.
Példák
1. példa: Az összes végrehajtási szabályzat lekérése
Ez a parancs az egyes hatókörök végrehajtási szabályzatait jeleníti meg az elsőbbségi sorrendben.
Get-ExecutionPolicy -List
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser AllSigned
LocalMachine Undefined
A Get-ExecutionPolicy
parancsmag a List paraméterrel jeleníti meg az egyes hatókörök végrehajtási szabályzatát.
2. példa: Végrehajtási szabályzat beállítása
Ez a példa bemutatja, hogyan állíthat be végrehajtási szabályzatot a helyi számítógéphez.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
Get-ExecutionPolicy -List
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser AllSigned
LocalMachine RemoteSigned
A Set-ExecutionPolicy
parancsmag a ExecutionPolicy paramétert használja a RemoteSigned
szabályzat megadásához. A Hatókör paraméter az alapértelmezett hatókörértéket adja meg. LocalMachine
A végrehajtási szabályzat beállításainak megtekintéséhez használja a Get-ExecutionPolicy
parancsmagot a List paraméterrel.
3. példa: Az érvényes végrehajtási szabályzat lekérése
Ez a példa bemutatja, hogyan jelenítheti meg a PowerShell-munkamenetek hatályos végrehajtási szabályzatát.
PS> Get-ExecutionPolicy -List
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser AllSigned
LocalMachine RemoteSigned
PS> Get-ExecutionPolicy
AllSigned
A Get-ExecutionPolicy
parancsmag a List paraméterrel jeleníti meg az egyes hatókörök végrehajtási szabályzatát. A Get-ExecutionPolicy
parancsmag paraméter nélkül fut a tényleges végrehajtási szabályzat megjelenítéséhez. AllSigned
4. példa: Szkript blokkolásának feloldása a futtatáshoz a végrehajtási szabályzat módosítása nélkül
Ez a példa bemutatja, hogyan akadályozza meg a RemoteSigned
végrehajtási szabályzat az aláíratlan szkriptek futtatását.
A parancsmag használata Unblock-File
előtt ajánlott elolvasni a szkript kódját, és ellenőrizni, hogy biztonságos-e. A Unblock-File
parancsmag feloldja a szkriptek letiltását, így futtathatók, de nem módosítja a végrehajtási szabályzatot.
PS> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
PS> Get-ExecutionPolicy
RemoteSigned
PS> .\Start-ActivityTracker.ps1
.\Start-ActivityTracker.ps1 : File .\Start-ActivityTracker.ps1 cannot be loaded.
The file .\Start-ActivityTracker.ps1 is not digitally signed.
The script will not execute on the system.
For more information, see about_Execution_Policies at https://go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:1
+ .\Start-ActivityTracker.ps1
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : NotSpecified: (:) [], PSSecurityException
+ FullyQualifiedErrorId : UnauthorizedAccess
PS> Unblock-File -Path .\Start-ActivityTracker.ps1
PS> Get-ExecutionPolicy
RemoteSigned
PS> .\Start-ActivityTracker.ps1
Task 1:
A Set-ExecutionPolicy
rendszer a ExecutionPolicy paramétert használja a RemoteSigned
szabályzat megadásához. A házirend az alapértelmezett hatókörhöz van beállítva. LocalMachine
A Get-ExecutionPolicy
parancsmag azt mutatja, hogy RemoteSigned
ez az aktuális PowerShell-munkamenet tényleges végrehajtási szabályzata.
A Start-ActivityTracker.ps1
szkript az aktuális könyvtárból lesz végrehajtva. A szkript le van tiltva RemoteSigned
, mert a szkript nincs digitálisan aláírva.
Ebben a példában a szkript kódját ellenőrizték és biztonságosként ellenőrizték. A Unblock-File
parancsmag a Path paraméter használatával oldja fel a szkript letiltását.
Annak ellenőrzéséhez, hogy Unblock-File
nem módosította-e a végrehajtási szabályzatot, Get-ExecutionPolicy
megjeleníti az érvényes végrehajtási szabályzatot. RemoteSigned
A szkript Start-ActivityTracker.ps1
az aktuális könyvtárból lesz végrehajtva. A szkript elkezd futni, mert a parancsmag feloldotta a Unblock-File
letiltást.
Paraméterek
-List
Lekéri a munkamenet összes végrehajtási szabályzatértékét. Alapértelmezés szerint Get-ExecutionPolicy
csak az érvényes végrehajtási szabályzatot kapja meg.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Meghatározza a végrehajtási szabályzat által érintett hatókört.
A tényleges végrehajtási szabályzatot az alábbi sorrend határozza meg:
MachinePolicy
. Csoportházirend szerint állítsa be a számítógép összes felhasználója számára.UserPolicy
. A számítógép aktuális felhasználójának csoportházirenddel történő beállítása.Process
. Csak az aktuális PowerShell-munkamenetre van hatással.LocalMachine
. Alapértelmezett hatókör, amely a számítógép összes felhasználóját érinti.CurrentUser
. Csak az aktuális felhasználót érinti.
Type: | ExecutionPolicyScope |
Accepted values: | CurrentUser, LocalMachine, MachinePolicy, Process, UserPolicy |
Position: | 0 |
Default value: | Effective execution policy |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
A parancsmag mindig Korlátlan értéket ad vissza Linux és macOS platformokon. Windows-platformokon az aktuális végrehajtási szabályzatot adja vissza.
Jegyzetek
A végrehajtási szabályzat a PowerShell biztonsági stratégiájának része. A végrehajtási szabályzatok határozzák meg, hogy betölthetők-e konfigurációs fájlok, például a PowerShell-profil vagy futtathatók-e szkriptek. És azt is, hogy a szkripteket a futtatás előtt digitálisan alá kell-e írni.