Get-ExecutionPolicy
Lekéri az aktuális munkamenet végrehajtási szabályzatát.
Syntax
All
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 Get-ExecutionPolicy -List. A PowerShell-munkamenet érvényes végrehajtási szabályzatának megtekintéséhez használja a Get-ExecutionPolicy paraméterek nélkül.
Az érvényes végrehajtási szabályzatot a Set-ExecutionPolicy és a csoportházirend beállításai által beállított végrehajtási szabályzatok határozzák meg.
További információért lásd az about_Execution_Policies részt .
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 Lista 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 Lista 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 Lista 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ályzata az aláíratlan szkriptek futtatását.
Ajánlott eljárás a szkript kódjának elolvasása és annak ellenőrzése, hogy biztonságos-e , mielőtt a Unblock-File parancsmagot használnánk. 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 az 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 a RemoteSigned 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 szkriptet a RemoteSigned blokkolja, mert a szkript nincs digitálisan aláírva.
Ebben a példában a szkript kódját átvizsgálták, és biztonságosnak bizonyult. A Unblock-File parancsmag a Path paramétert használja a szkript letiltásának feloldásához.
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 Start-ActivityTracker.ps1 szkript az aktuális könyvtárból lesz végrehajtva. A szkript azért kezd el futni, mert a Unblock-File parancsmag feloldotta.
Paraméterek
-List
Lekéri a munkamenet végrehajtási szabályzat összes értékét. Alapértelmezés szerint Get-ExecutionPolicy csak az érvényes végrehajtási szabályzatot kapja meg.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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 jelenlegi felhasználója számára csoportházirend által beállítva. -
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.
Paramétertulajdonságok
| Típus: | ExecutionPolicyScope |
| Alapértelmezett érték: | Effective execution policy |
| Elfogadott értékek: | CurrentUser, LocalMachine, MachinePolicy, Process, UserPolicy |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
ExecutionPolicy
A parancsmag mindig Korlátlan 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.