Get-ExecutionPolicy

  • Referencia
Modul:
Microsoft.PowerShell.Security

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

ExecutionPolicy

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.