Get-ExecutionPolicy
Hiermee haalt u het uitvoeringsbeleid voor de huidige sessie op.
Syntax
All
Get-ExecutionPolicy
[[-Scope] <ExecutionPolicyScope>]
[-List]
[<CommonParameters>]
Description
Als u het uitvoeringsbeleid voor elk bereik in de volgorde van prioriteit wilt weergeven, gebruikt u Get-ExecutionPolicy -List. Als u het effectieve uitvoeringsbeleid voor uw PowerShell-sessie wilt zien, gebruikt Get-ExecutionPolicy u geen parameters.
Het effectieve uitvoeringsbeleid wordt bepaald door uitvoeringsbeleid dat wordt ingesteld door Set-ExecutionPolicy instellingen voor groepsbeleid en groepsbeleid.
Zie about_Execution_Policiesvoor meer informatie.
Voorbeelden
Voorbeeld 1: Alle uitvoeringsbeleidsregels ophalen
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 Get-ExecutionPolicy cmdlet gebruikt de parameter List om het uitvoeringsbeleid van elk bereik weer te geven.
Voorbeeld 2: Een uitvoeringsbeleid instellen
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 Set-ExecutionPolicy cmdlet gebruikt de parameter ExecutionPolicy om het RemoteSigned beleid op te geven. Met de parameter Bereik geeft u de standaardwaarde voor het bereik op. LocalMachine
Als u de instellingen voor het uitvoeringsbeleid wilt weergeven, gebruikt u de Get-ExecutionPolicy cmdlet met de parameter List .
Voorbeeld 3: Het effectieve uitvoeringsbeleid ophalen
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 Get-ExecutionPolicy cmdlet 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.
Voorbeeld 4: Een script deblokkeren om het uit te voeren zonder het uitvoeringsbeleid te wijzigen
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 u de Unblock-File cmdlet gebruikt. De Unblock-File cmdlet blokkeert 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 parameter ExecutionPolicy wordt gebruikt om het RemoteSigned beleid op te geven. Het beleid is ingesteld voor het standaardbereik. LocalMachine
De Get-ExecutionPolicy cmdlet toont dat RemoteSigned het effectieve uitvoeringsbeleid voor de huidige PowerShell-sessie is.
Het Start-ActivityTracker.ps1 script wordt uitgevoerd vanuit de huidige map. Het script wordt geblokkeerd omdat RemoteSigned het script niet digitaal is ondertekend.
In dit voorbeeld is de code van het script gecontroleerd en geverifieerd als veilig uit te voeren. De Unblock-File cmdlet gebruikt de parameter Path om het script te deblokkeren.
Als u wilt controleren of Unblock-File het uitvoeringsbeleid niet is gewijzigd, Get-ExecutionPolicy wordt het effectieve uitvoeringsbeleid weergegeven. RemoteSigned
Het script wordt Start-ActivityTracker.ps1 uitgevoerd vanuit de huidige map. Het script wordt uitgevoerd omdat het is gedeblokkeerd door de Unblock-File cmdlet.
Parameters
-List
Hiermee worden alle uitvoeringsbeleidswaarden voor de sessie opgehaald.
Get-ExecutionPolicy Standaard wordt alleen het effectieve uitvoeringsbeleid weergegeven.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Scope
Hiermee geeft u het bereik op dat wordt beïnvloed door een uitvoeringsbeleid.
Het effectieve uitvoeringsbeleid wordt als volgt bepaald door de volgorde van prioriteit:
-
MachinePolicy. Ingesteld door een groepsbeleid voor alle gebruikers van de computer. -
UserPolicy. Ingesteld door een groepsbeleid voor de huidige gebruiker van de computer. -
Process. Is alleen van invloed op de huidige PowerShell-sessie. -
LocalMachine. Standaardbereik dat van invloed is op alle gebruikers van de computer. -
CurrentUser. Is alleen van invloed op de huidige gebruiker.
Parametereigenschappen
| Type: | ExecutionPolicyScope |
| Default value: | Effective execution policy |
| Geaccepteerde waarden: | CurrentUser, LocalMachine, MachinePolicy, Process, UserPolicy |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
None
U kunt geen objecten doorsluisen naar deze cmdlet.
Uitvoerwaarden
ExecutionPolicy
De cmdlet retourneert altijd Onbeperkt op Linux- en macOS-platforms. Op Windows platforms wordt het huidige uitvoeringsbeleid geretourneerd.
Notities
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.