Megosztás a következőn keresztül:


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.