Get-ExecutionPolicy

Get-ExecutionPolicy
    [[-Scope] <ExecutionPolicyScope>]
    [-List]
    [<CommonParameters>]

Gebruik Get-ExecutionPolicy -Listom het uitvoeringsbeleid voor elk bereik weer te geven in volgorde van prioriteit. Als u het effectieve uitvoeringsbeleid voor uw PowerShell-sessie wilt zien, gebruikt u Get-ExecutionPolicy zonder parameters.

Het effectieve uitvoeringsbeleid wordt bepaald door uitvoeringsbeleidsregels die zijn ingesteld door Set-ExecutionPolicy en door groepsbeleidsinstellingen.

Zie about_Execution_Policiesvoor meer informatie.

Met deze opdracht worden de uitvoeringsbeleidsregels voor elk bereik weergegeven in volgorde van prioriteit.

Get-ExecutionPolicy -List

Scope          ExecutionPolicy
-----          ---------------
MachinePolicy  Undefined
UserPolicy     Undefined
Process        Undefined
CurrentUser    AllSigned
LocalMachine   Undefined

De cmdlet Get-ExecutionPolicy gebruikt de parameter List om het uitvoeringsbeleid van elk bereik weer te geven.

In dit voorbeeld ziet u hoe u een uitvoeringsbeleid instelt voor de lokale computer.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
Get-ExecutionPolicy -List

        Scope ExecutionPolicy
        ----- ---------------
MachinePolicy       Undefined
   UserPolicy       Undefined
      Process       Undefined
  CurrentUser       AllSigned
 LocalMachine    RemoteSigned

De cmdlet Set-ExecutionPolicy gebruikt de parameter ExecutionPolicy om het RemoteSigned-beleid op te geven. De parameter Bereik specificeert de standaardbereikwaarde, LocalMachine. Als u de instellingen voor het uitvoeringsbeleid wilt weergeven, gebruikt u de cmdlet Get-ExecutionPolicy met de parameter List.

In dit voorbeeld ziet u hoe u het effectieve uitvoeringsbeleid voor een PowerShell-sessie kunt weergeven.

PS> Get-ExecutionPolicy -List

        Scope ExecutionPolicy
        ----- ---------------
MachinePolicy       Undefined
   UserPolicy       Undefined
      Process       Undefined
  CurrentUser       AllSigned
 LocalMachine    RemoteSigned

PS> Get-ExecutionPolicy

AllSigned

De cmdlet Get-ExecutionPolicy gebruikt de parameter List om het uitvoeringsbeleid van elk bereik weer te geven. De Get-ExecutionPolicy cmdlet wordt uitgevoerd zonder een parameter om het effectieve uitvoeringsbeleid weer te geven, AllSigned.

In dit voorbeeld ziet u hoe het RemoteSigned uitvoeringsbeleid voorkomt dat u niet-ondertekende scripts uitvoert.

Een best practice is om de code van het script te lezen en te controleren of het veilig is voordat de Unblock-File cmdlet gebruikt. De Unblock-File cmdlet deblokkert scripts zodat ze kunnen worden uitgevoerd, maar wijzigt het uitvoeringsbeleid niet.

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:

De Set-ExecutionPolicy gebruikt de parameter ExecutionPolicy om het RemoteSigned-beleid op te geven. Het beleid is ingesteld voor het standaardbereik, LocalMachine.

De Get-ExecutionPolicy cmdlet geeft aan dat RemoteSigned het effectieve uitvoeringsbeleid is voor de huidige PowerShell-sessie.

Het Start-ActivityTracker.ps1 script wordt uitgevoerd vanuit de huidige directory. Het script wordt geblokkeerd door RemoteSigned omdat het script niet digitaal is ondertekend.

In dit voorbeeld is de code van het script gecontroleerd en geverifieerd als veilig uit te voeren. De cmdlet Unblock-File maakt gebruik van de parameter Path om het script te deblokkeren.

Als u wilt controleren of Unblock-File het uitvoeringsbeleid niet heeft gewijzigd, Get-ExecutionPolicy het effectieve uitvoeringsbeleid weergeeft, RemoteSigned.

Het script Start-ActivityTracker.ps1 wordt uitgevoerd vanuit de huidige map. Het script wordt uitgevoerd omdat het is gedeblokkeerd door de Unblock-File-cmdlet.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt geen objecten doorsluisen naar deze cmdlet.

De cmdlet retourneert altijd Onbeperkte op Linux- en macOS-platforms. Op Windows-platformen retourneert het het huidige uitvoeringsbeleid.

Een uitvoeringsbeleid maakt deel uit van de PowerShell-beveiligingsstrategie. Uitvoeringsbeleid bepaalt of u configuratiebestanden, zoals uw PowerShell-profiel, kunt laden of scripts kunt uitvoeren. En of scripts digitaal moeten worden ondertekend voordat ze worden uitgevoerd.