about_Execution_Policies
Kurze Beschreibung
Beschreibt die PowerShell-Ausführungsrichtlinien und erläutert, wie sie verwaltet werden.
Lange Beschreibung
Die Ausführungsrichtlinie von PowerShell ist ein Sicherheitsfeature, das die Bedingungen steuert, unter denen PowerShell Konfigurationsdateien lädt und Skripts ausführt. Dieses Feature hilft, die Ausführung schädlicher Skripts zu verhindern.
Auf einem Windows-Computer können Sie eine Ausführungsrichtlinie für den lokalen Computer, für den aktuellen Benutzer oder für eine bestimmte Sitzung festlegen. Sie können auch eine Gruppenrichtlinieneinstellung verwenden, um Ausführungsrichtlinien für Computer und Benutzer festzulegen.
Ausführungsrichtlinien für den lokalen Computer und den aktuellen Benutzer werden in der Registrierung gespeichert. Sie müssen keine Ausführungsrichtlinien in Ihrem PowerShell-Profil festlegen. Die Ausführungsrichtlinie für eine bestimmte Sitzung wird nur im Arbeitsspeicher gespeichert und geht verloren, wenn die Sitzung geschlossen wird.
Die Ausführungsrichtlinie ist kein Sicherheitssystem, das Benutzeraktionen einschränkt. Beispielsweise können Benutzer eine Richtlinie einfach umgehen, indem sie den Skriptinhalt an der Befehlszeile eingeben, wenn sie kein Skript ausführen können. Stattdessen hilft die Ausführungsrichtlinie Benutzern, grundlegende Regeln festzulegen, und verhindert, dass sie unbeabsichtigt gegen sie verstoßen.
Auf Nicht-Windows-Computern ist Unrestricted die Standardausführungsrichtlinie und kann nicht geändert werden. Das Set-ExecutionPolicy Cmdlet ist verfügbar, aber PowerShell zeigt eine Konsolenmeldung an, dass es nicht unterstützt wird. Während Get-ExecutionPolicy auf Nicht-Windows-Plattformen zurückgegeben Unrestricted wird, stimmt das Verhalten wirklich übereinBypass, da diese Plattformen die Windows-Sicherheit Zonen nicht implementieren.
PowerShell-Ausführungsrichtlinien
Die Durchsetzung dieser Richtlinien erfolgt nur auf Windows-Plattformen. Die PowerShell-Ausführungsrichtlinien sind wie folgt:
AllSigned- Skripts können ausgeführt werden.
- Erfordert, dass alle Skripts und Konfigurationsdateien von einem vertrauenswürdigen Herausgeber signiert sind, einschließlich Skripts, die auf dem lokalen Computer geschrieben werden.
- Fordert Sie vor dem Ausführen von Skripts von Herausgebern auf, die Sie noch nicht als vertrauenswürdig oder nicht vertrauenswürdig eingestuft haben.
- Riskiert die Ausführung signierter, aber böswilliger Skripts.
Bypass- Es findet keine Blockierung statt und es werden keine Warnungen oder Eingabeaufforderungen ausgegeben.
- Diese Ausführungsrichtlinie ist für Konfigurationen konzipiert, in denen ein PowerShell-Skript in eine größere Anwendung integriert ist, oder für Konfigurationen, in denen PowerShell die Grundlage für ein Programm ist, das über ein eigenes Sicherheitsmodell verfügt.
Default- Legt die Standardausführungsrichtlinie fest.
- Restricted für Windows-Clients.
- RemoteSigned für Windows-Server.
RemoteSigned- Die Standardausführungsrichtlinie für Windows-Servercomputer.
- Skripts können ausgeführt werden.
- Erfordert eine digitale Signatur eines vertrauenswürdigen Herausgebers für Skripts und Konfigurationsdateien, die aus dem Internet heruntergeladen werden, einschließlich E-Mail- und Chatprogrammen.
- Erfordert keine digitalen Signaturen für Skripts, die auf dem lokalen Computer geschrieben und nicht aus dem Internet heruntergeladen werden.
- Führt Skripts aus, die aus dem Internet heruntergeladen und nicht signiert werden, wenn die Skripts aufgehoben werden, z. B. mithilfe des Cmdlets
Unblock-File. - Riskieren Sie das Ausführen von nicht signierten Skripts aus anderen Quellen als dem Internet und signierten Skripts, die böswillig sein könnten.
Restricted- Die Standardausführungsrichtlinie für Windows-Clientcomputer.
- Erlaubt einzelne Befehle, aber keine Skripts.
- Verhindert die Ausführung aller Skriptdateien, einschließlich Formatierungs- und Konfigurationsdateien (
.ps1xml), Modulskriptdateien (.psm1) und PowerShell-Profile (.ps1).
Undefined- Im aktuellen Bereich ist keine Ausführungsrichtlinie festgelegt.
- Wenn die Ausführungsrichtlinie in allen Bereichen lautet, gilt UndefinedRestricted die effektive Ausführungsrichtlinie für Windows-Clients und RemoteSigned für Windows Server.
Unrestricted- Die Standardausführungsrichtlinie für Nicht-Windows-Computer und kann nicht geändert werden.
- Nicht signierte Skripts können ausgeführt werden. Es besteht das Risiko, böswillige Skripts auszuführen.
- Warnt den Benutzer vor dem Ausführen von Skripts und Konfigurationsdateien, die nicht aus der lokalen Intranetzone stammen.
Hinweis
Auf Systemen, die keine UNC-Pfade (Universal Naming Convention) von Internetpfaden unterscheiden, dürfen Skripts, die durch einen UNC-Pfad identifiziert werden, möglicherweise nicht mit der RemoteSigned-Ausführungsrichtlinie ausgeführt werden.
Ausführungsrichtlinienbereich
Sie können eine Ausführungsrichtlinie festlegen, die nur in einem bestimmten Bereich wirksam ist.
Die gültigen Werte für Scope sind MachinePolicy, UserPolicy, Process, CurrentUser und LocalMachine. LocalMachine ist die Standardeinstellung beim Festlegen einer Ausführungsrichtlinie.
Die Scope Werte werden in Rangfolge aufgeführt. Die Richtlinie, die Vorrang hat, ist in der aktuellen Sitzung wirksam, auch wenn eine restriktivere Richtlinie auf einer niedrigeren Rangebene festgelegt wurde.
Weitere Informationen finden Sie unter Set-ExecutionPolicy.
MachinePolicy
Durch einen Gruppenrichtlinie für alle Benutzer des Computers festgelegt.
UserPolicy
Wird von einem Gruppenrichtlinie für den aktuellen Benutzer des Computers festgelegt.
Process
Der Process Bereich wirkt sich nur auf die aktuelle PowerShell-Sitzung aus. Die Ausführungsrichtlinie wird nicht in der Registrierung, sondern in der Umgebungsvariable
$env:PSExecutionPolicyPreferencegespeichert. Wenn die PowerShell-Sitzung geschlossen wird, werden die Variable und der Wert gelöscht.CurrentUser
Die Ausführungsrichtlinie wirkt sich nur auf den aktuellen Benutzer aus. Es wird im HKEY_CURRENT_USER Registrierungsunterschlüssel gespeichert.
LocalMachine
Die Ausführungsrichtlinie wirkt sich auf alle Benutzer auf dem aktuellen Computer aus. Es wird im HKEY_LOCAL_MACHINE Registrierungsunterschlüssel gespeichert.
Verwalten der Ausführungsrichtlinie mit PowerShell
Verwenden Sie das Cmdlet, um die effektive Ausführungsrichtlinie für die aktuelle PowerShell-Sitzung Get-ExecutionPolicy abzurufen.
Mit dem folgenden Befehl wird die effektive Ausführungsrichtlinie abgerufen:
Get-ExecutionPolicy
So rufen Sie alle Ausführungsrichtlinien ab, die sich auf die aktuelle Sitzung auswirken, und zeigen sie in Rangfolge an:
Get-ExecutionPolicy -List
Das Ergebnis ähnelt der folgenden Beispielausgabe:
Scope ExecutionPolicy
----- ---------------
MachinePolicy Undefined
UserPolicy Undefined
Process Undefined
CurrentUser RemoteSigned
LocalMachine AllSigned
In diesem Fall ist die effektive Ausführungsrichtlinie RemoteSigned , da die Ausführungsrichtlinie für den aktuellen Benutzer Vorrang vor der Für den lokalen Computer festgelegten Ausführungsrichtlinie hat.
Um die Ausführungsrichtlinie für einen bestimmten Bereich abzurufen, verwenden Sie den Scope Parameter von Get-ExecutionPolicy.
Der folgende Befehl ruft beispielsweise die Ausführungsrichtlinie für den CurrentUser-Bereich ab:
Get-ExecutionPolicy -Scope CurrentUser
Ändern der Ausführungsrichtlinie
Verwenden Sie das Cmdlet, um die PowerShell-Ausführungsrichtlinie Set-ExecutionPolicy auf Ihrem Windows-Computer zu ändern. Die Änderung wird sofort wirksam. Sie müssen PowerShell nicht neu starten.
Wenn Sie die Ausführungsrichtlinie für die Bereiche LocalMachine oder CurrentUser festlegen, wird die Änderung in der Registrierung gespeichert und bleibt wirksam, bis Sie sie erneut ändern.
Wenn Sie die Ausführungsrichtlinie für den Process Bereich festlegen, wird sie nicht in der Registrierung gespeichert. Die Ausführungsrichtlinie wird beibehalten, bis der aktuelle Prozess und alle untergeordneten Prozesse geschlossen werden.
Hinweis
Starten Sie In Windows Vista und höheren Versionen von Windows PowerShell mit der Option Als Administrator ausführen, um Befehle auszuführen, die die Ausführungsrichtlinie für den lokalen Computer ändern, den Bereich LocalMachine.
So ändern Sie Ihre Ausführungsrichtlinie:
Set-ExecutionPolicy -ExecutionPolicy <PolicyName>
Beispiel:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
So legen Sie die Ausführungsrichtlinie in einem bestimmten Bereich fest:
Set-ExecutionPolicy -ExecutionPolicy <PolicyName> -Scope <scope>
Beispiel:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Ein Befehl zum Ändern einer Ausführungsrichtlinie kann erfolgreich sein, aber die effektive Ausführungsrichtlinie nicht ändern.
Beispielsweise kann ein Befehl, der die Ausführungsrichtlinie für den lokalen Computer festlegt, erfolgreich sein, aber von der Ausführungsrichtlinie für den aktuellen Benutzer überschrieben werden.
Entfernen der Ausführungsrichtlinie
Um die Ausführungsrichtlinie für einen bestimmten Bereich zu entfernen, legen Sie die Ausführungsrichtlinie auf fest Undefined.
So entfernen Sie beispielsweise die Ausführungsrichtlinie für alle Benutzer des lokalen Computers:
Set-ExecutionPolicy -ExecutionPolicy Undefined -Scope LocalMachine
So entfernen Sie die Ausführungsrichtlinie für einen Scope:
Set-ExecutionPolicy -ExecutionPolicy Undefined -Scope CurrentUser
Wenn keine Ausführungsrichtlinie in einem Bereich festgelegt ist, lautet Restricteddie effektive Ausführungsrichtlinie , was die Standardeinstellung für Windows-Clients ist.
Festlegen einer anderen Richtlinie für eine Sitzung
Sie können den ExecutionPolicy-Parameter von pwsh.exe verwenden, um eine Ausführungsrichtlinie für eine neue PowerShell-Sitzung festzulegen. Die Richtlinie wirkt sich nur auf die aktuelle Sitzung und die untergeordneten Sitzungen aus.
Um die Ausführungsrichtlinie für eine neue Sitzung festzulegen, starten Sie PowerShell über die Befehlszeile, z cmd.exe . B. oder über PowerShell, und verwenden Sie dann den ExecutionPolicy-Parameter von pwsh.exe , um die Ausführungsrichtlinie festzulegen.
Beispiel:
pwsh.exe -ExecutionPolicy AllSigned
Die von Ihnen festgelegte Ausführungsrichtlinie wird nicht in der Registrierung gespeichert. Stattdessen wird sie in der Umgebungsvariablen $env:PSExecutionPolicyPreference gespeichert. Die Variable wird gelöscht, wenn Sie die Sitzung schließen, in der die Richtlinie festgelegt ist. Sie können die Richtlinie nicht ändern, indem Sie den Variablenwert bearbeiten.
Während der Sitzung hat die für die Sitzung festgelegte Ausführungsrichtlinie Vorrang vor einer Ausführungsrichtlinie, die in der Registrierung für den lokalen Computer oder aktuellen Benutzer festgelegt ist. Es hat jedoch keinen Vorrang vor der Ausführungsrichtlinie, die mithilfe eines Gruppenrichtlinie festgelegt wird.
Verwenden von Gruppenrichtlinie zum Verwalten der Ausführungsrichtlinie
Sie können die Einstellung Skriptausführung aktivieren Gruppenrichtlinie verwenden, um die Ausführungsrichtlinie von Computern in Ihrem Unternehmen zu verwalten. Die Gruppenrichtlinieneinstellung setzt die in PowerShell festgelegten Ausführungsrichtlinien in allen Bereichen außer Kraft.
Die Richtlinieneinstellungen für Skriptausführung aktivieren sind wie folgt:
Wenn Sie Skriptausführung aktivieren deaktivieren, werden Skripts nicht ausgeführt. Dies entspricht der Ausführungsrichtlinie Restricted .
Wenn Sie Skriptausführung aktivieren aktivieren, können Sie eine Ausführungsrichtlinie auswählen. Die Gruppenrichtlinieneinstellungen entsprechen den folgenden Ausführungsrichtlinieneinstellungen:
Gruppenrichtlinie Ausführungsrichtlinie Alle Skripts zulassen Unrestricted Lokale Skripts und remote signierte Skripts zulassen RemoteSigned Nur signierte Skripts zulassen AllSigned Wenn Skriptausführung aktivieren nicht konfiguriert ist, hat dies keine Auswirkung. Die in PowerShell festgelegte Ausführungsrichtlinie ist wirksam.
Die Dateien PowerShellExecutionPolicy.adm und PowerShellExecutionPolicy.admx fügen die Richtlinie Skriptausführung aktivieren zu den Knoten „Computerkonfiguration“ und „Benutzerkonfiguration“ im Gruppenrichtlinien-Editor in den folgenden Pfaden hinzu.
Für Windows XP und Windows Server 2003:
Administrative Templates\Windows Components\Windows PowerShell
Für Windows Vista und höhere Versionen von Windows:
Administrative Templates\Classic Administrative Templates\Windows Components\Windows PowerShell
Richtlinien, die im Knoten „Computerkonfiguration“ festgelegt sind, haben Vorrang vor Richtlinien, die im Knoten „Benutzerkonfiguration“ festgelegt sind.
Weitere Informationen finden Sie unter about_Group_Policy_Settings.
Rangfolge der Ausführungsrichtlinie
Beim Ermitteln der effektiven Ausführungsrichtlinie für eine Sitzung wertet PowerShell die Ausführungsrichtlinien in der folgenden Rangfolge aus:
Group Policy: MachinePolicy
Group Policy: UserPolicy
Execution Policy: Process (or pwsh.exe -ExecutionPolicy)
Execution Policy: LocalMachine
Execution Policy: CurrentUser
Verwalten von signierten und nicht signierten Skripts
Unter Windows fügen Programme wie Internet Explorer und Microsoft Edge dateien, die heruntergeladen werden, einen alternativen Datenstrom hinzu. Dadurch wird die Datei als "aus dem Internet kommend" markiert. Wenn Ihre PowerShell-Ausführungsrichtlinie RemoteSigned ist, führt PowerShell keine nicht signierten Skripts aus, die aus dem Internet heruntergeladen werden, einschließlich E-Mail- und Chatprogrammen.
Sie können das Skript signieren oder ein skript ohne Vorzeichen ausführen, ohne die Ausführungsrichtlinie zu ändern.
Ab PowerShell 3.0 können Sie den parameter Stream des Get-Item Cmdlets verwenden, um Dateien zu erkennen, die blockiert sind, weil sie aus dem Internet heruntergeladen wurden. Verwenden Sie das Unblock-File Cmdlet, um die Blockierung der Skripts aufzuheben, damit Sie sie in PowerShell ausführen können.
Weitere Informationen finden Sie unter about_Signing, Get-Item und Unblock-File.
Hinweis
Andere Methoden zum Herunterladen von Dateien markieren die Dateien möglicherweise nicht als aus der Internetzone stammen. Beispiele hierfür sind:
curl.exeInvoke-RestMethodInvoke-WebRequest
Ausführungsrichtlinie für Windows Server Core und Windows Nano Server
Wenn PowerShell 6 unter Windows Server Core oder Windows Nano Server unter bestimmten Bedingungen ausgeführt wird, können Ausführungsrichtlinien mit dem folgenden Fehler fehlschlagen:
AuthorizationManager check failed.
At line:1 char:1
+ C:\scriptpath\scriptname.ps1
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : SecurityError: (:) [], PSSecurityException
+ FullyQualifiedErrorId : UnauthorizedAccess
PowerShell verwendet APIs in der Windows Desktop Shell (explorer.exe), um die Zone einer Skriptdatei zu überprüfen. Die Windows Shell ist unter Windows Server Core und Windows Nano Server nicht verfügbar.
Sie können diesen Fehler auch auf einem beliebigen Windows-System erhalten, wenn die Windows-Desktopshell nicht verfügbar ist oder nicht reagiert. Beispielsweise kann während der Anmeldung ein PowerShell-Anmeldeskript die Ausführung starten, bevor der Windows-Desktop bereit ist, was zu einem Fehler führt.
Die Verwendung einer Ausführungsrichtlinie von ByPass oder AllSigned erfordert keine Zonenüberprüfung, die das Problem vermeidet.