Ruft die Ausführungsrichtlinien für die aktuelle Sitzung ab.
Syntax
Get-ExecutionPolicy [[-Scope] {<Process> | <CurrentUser> | <LocalMachine> | <UserPolicy> | <MachinePolicy>}] [-List] [<CommonParameters>]
Beschreibung
Das Cmdlet "Get-ExecutionPolicy" ruft die Ausführungsrichtlinien für die aktuelle Sitzung ab.
Die Ausführungsrichtlinie wird von Ausführungsrichtlinien bestimmt, die mit Set-ExecutionPolicy und den Gruppenrichtlinieneinstellungen für die Windows PowerShell-Ausführungsrichtlinie festgelegt werden. Der Standardwert ist "Restricted".
Mit dem Cmdlet "Get-ExecutionPolicy" wird die Ausführungsrichtlinie, die in der aktuellen Sitzung wirksam ist, ohne Angabe von Parametern abgerufen. Sie können alle Ausführungsrichtlinien, die sich auf die Sitzung oder den Scope-Parameter auswirken, mithilfe des List-Parameters abrufen, um die Ausführungsrichtlinie für einen bestimmten Bereich abzurufen.
Weitere Informationen finden Sie unter "about_Execution_Policies".
Parameter
-List
Ruft alle Werte der Ausführungsrichtlinie für die Sitzung in ihrer Rangfolge ab. Get-ExecutionPolicy ruft standardmäßig nur die gültige Ausführungsrichtlinie ab.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
False |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Scope <ExecutionPolicyScope>
Ruft die Ausführungsrichtlinie im angegebenen Bereich ab. Get-ExecutionPolicy ruft standardmäßig die gültige Ausführungsrichtlinie für die aktuelle Sitzung ab.
Gültige Werte:
– MachinePolicy: Die von einer Gruppenrichtlinie für alle Benutzer des Computers festgelegte Ausführungsrichtlinie.
– UserPolicy: Die von einer Gruppenrichtlinie für den aktuellen Benutzer des Computers festgelegte Ausführungsrichtlinie.
– Process: Die Ausführungsrichtlinie, die für den aktuellen Windows PowerShell-Prozess festgelegt wurde.
– CurrentUser: Die Ausführungsrichtlinie, die für den aktuellen Benutzer festgelegt wurde.
– LocalMachine: Die Ausführungsrichtlinie, die für alle Benutzer des Computers festgelegt wurde.
|
Erforderlich? |
false |
|
Position? |
1 |
|
Standardwert |
Effective execution policy |
|
Pipelineeingaben akzeptieren? |
true (ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
None Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden. |
|
Ausgaben |
Microsoft.PowerShell.ExecutionPolicy Get-ExecutionPolicy gibt ein Objekt für jede Ausführungsrichtlinie zurück, die das Cmdlet abruft. |
Hinweise
Mit Get-ExecutionPolicy können keine speziellen Ausführungsrichtlinien abgerufen werden, die für einen bestimmten Bereich festgelegt sind. Zudem können keine Ausführungsrichtlinien abgerufen werden, die von einer Gruppenrichtlinie festgelegt werden. Mit Get-ExecutionPolicy wird nur die geltende Ausführungsrichtlinie abgerufen, die durch Anwenden sämtlicher Rangfolgenregeln erhalten wird.
Die Ausführungsrichtlinie ist Teil der Sicherheitsstrategie von Windows PowerShell. Sie bestimmt, ob Konfigurationsdateien (einschließlich des Windows PowerShell-Profils) geladen und Skripts ausgeführt werden können. Ferner wird festgelegt, welche Skripts digital signiert werden müssen, bevor sie ausgeführt werden können.
Die geltende Ausführungsrichtlinie wird von den Richtlinien bestimmt, die mit Set-ExecutionPolicy und den Gruppenrichtlinien zum Aktivieren der Ausführung von Skripts für Computer und Benutzer festgelegt werden. Die Rangfolge lautet: Computergruppenrichtlinie > Benutzergruppenrichtlinie > Prozessausführungsrichtlinie (Sitzung) > Benutzerausführungsrichtlinie > Computerausführungsrichtlinie.
Weitere Informationen zur Windows PowerShell-Ausführungsrichtlinie, einschließlich Definitionen der Windows PowerShell-Richtlinien, finden Sie unter "about_Execution_Policies".
Beispiel 1
C:\PS>get-executionpolicy Restricted Beschreibung ----------- Mit diesem Befehl wird die aktuelle Ausführungsrichtlinie für die Shell abgerufen.
Beispiel 2
C:\PS>set-executionpolicy RemoteSigned; get-executionPolicy RemoteSigned Beschreibung ----------- Mit diesen Befehlen wird eine neue Benutzereinstellung für die Ausführungsrichtlinie der Shell festgelegt, und die geltende Ausführungsrichtlinie wird angezeigt. Die Befehle sind mit einem Semikolon (;) getrennt. In diesem Beispiel stellt die Benutzereinstellung die geltende Richtlinie für die Shell dar, da keine Gruppenrichtlinieneinstellung vorhanden ist.
Beispiel 3
C:\PS>get-executionpolicy -list
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser AllSigned
LocalMachine RemoteSigned
C:\PS> get-executionpolicy
AllSigned
Beschreibung
-----------
Mit diesen Befehlen werden alle Ausführungsrichtlinien in der aktuellen Sitzung und der gültigen Ausführungsrichtlinie abgerufen.
Mit dem ersten Befehl werden alle Ausführungsrichtlinien abgerufen, die sich auf die aktuelle Sitzung auswirken. Die Richtlinien werden in der Rangfolge aufgeführt.
Mit dem zweiten Befehl wird nur die gültige Ausführungsrichtlinie abgerufen, die im CurrentUser-Bereich festgelegt wurde.
Siehe auch