about_Profiles

  • Artikel

Kurze Beschreibung

Beschreibt das Erstellen und Verwenden eines PowerShell-Profils.

Lange Beschreibung

Sie können ein PowerShell-Profil erstellen, um Ihre Umgebung anzupassen und sitzungsspezifische Elemente zu jeder powerShell-Sitzung hinzuzufügen, die Sie starten.

Ein PowerShell-Profil ist ein Skript, das ausgeführt wird, wenn PowerShell gestartet wird. Sie können das Profil als Startskript verwenden, um Ihre Umgebung anzupassen. Sie können Befehle, Aliase, Funktionen, Variablen, Module, PowerShell-Laufwerke und vieles mehr hinzufügen. Sie können Ihrem Profil auch andere sitzungsspezifische Elemente hinzufügen, damit sie in jeder Sitzung verfügbar sind, ohne sie importieren oder erneut erstellen zu müssen.

PowerShell unterstützt mehrere Profile für Benutzer und Hostprogramme. Die Profile werden jedoch nicht für Sie erstellt.

Profiltypen und Speicherorte

PowerShell unterstützt mehrere Profildateien, die für Benutzer und PowerShell-Hosts gelten. Sie können ein beliebiges oder alle diese Profile auf Ihrem Computer haben.

Die PowerShell-Konsole unterstützt die folgenden grundlegenden Profildateien. Diese Dateipfade sind die Standardspeicherorte.

  • Alle Benutzer, alle Hosts
    • Windows – $PSHOME\Profile.ps1
    • Linux: /opt/microsoft/powershell/7/profile.ps1
    • macOS: /usr/local/microsoft/powershell/7/profile.ps1
  • Alle Benutzer, aktueller Host
    • Windows – $PSHOME\Microsoft.PowerShell_profile.ps1
    • Linux: /opt/microsoft/powershell/7/Microsoft.PowerShell_profile.ps1
    • macOS: /usr/local/microsoft/powershell/7/Microsoft.PowerShell_profile.ps1
  • Aktueller Benutzer, alle Hosts
    • Windows – $HOME\Documents\PowerShell\Profile.ps1
    • Linux: ~/.config/powershell/profile.ps1
    • macOS: ~/.config/powershell/profile.ps1
  • Aktueller Benutzer, aktueller Host
    • Windows – $HOME\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
    • Linux: ~/.config/powershell/Microsoft.PowerShell_profile.ps1
    • macOS: ~/.config/powershell/Microsoft.PowerShell_profile.ps1

Hinweis

In Windows kann der Speicherort des Documents Ordners durch ordnerumleitung oder OneDrive geändert werden. Es wird nicht empfohlen, den Documents Ordner auf eine Netzwerkfreigabe umzuleiten oder ihn in OneDrive einzugeben. Das Umleiten des Ordners kann dazu führen, dass Module nicht geladen und Fehler in Ihren Profilskripts erstellt werden. Informationen zum Entfernen des Ordners aus der Documents OneDrive-Verwaltung finden Sie in der OneDrive-Dokumentation.

Die Profilskripts werden in der aufgeführten Reihenfolge ausgeführt. Dies bedeutet, dass Änderungen, die im AllUsersAllHosts-Profil vorgenommen wurden, von einem der anderen Profilskripts überschrieben werden können. Das CurrentUserCurrentHost-Profil wird immer zuletzt ausgeführt. In der PowerShell-Hilfe ist das CurrentUserCurrentHost-Profil das Profil, das am häufigsten als Ihr PowerShell-Profil bezeichnet wird.

Andere Programme, die PowerShell hosten, können ihre eigenen Profile unterstützen. Visual Studio Code (VS Code) unterstützt beispielsweise die folgenden hostspezifischen Profile.

  • Alle Benutzer, aktueller Host - $PSHOME\Microsoft.VSCode_profile.ps1
  • Aktueller Benutzer, aktueller Host - $HOME\Documents\PowerShell\Microsoft.VSCode_profile.ps1

Die Profilpfade umfassen die folgenden Variablen:

  • Die $PSHOME Variable speichert das Installationsverzeichnis für PowerShell.
  • Die $HOME Variable speichert das Startverzeichnis des aktuellen Benutzers.

Hinweis

In Windows kann der Speicherort des Documents Ordners durch ordnerumleitung oder OneDrive geändert werden. Es wird nicht empfohlen, den Documents Ordner auf eine Netzwerkfreigabe umzuleiten oder ihn in OneDrive einzugeben. Das Umleiten des Ordners kann dazu führen, dass Module nicht geladen und Fehler in Ihren Profilskripts erstellt werden. Informationen zum Entfernen des Ordners aus der Documents OneDrive-Verwaltung finden Sie in der OneDrive-Dokumentation.

Die $PROFILE-Variable

Die automatische Variable $PROFILE speichert die Pfade zu den PowerShell-Profilen, die in der aktuellen Sitzung verfügbar sind.

Um einen Profilpfad anzuzeigen, zeigen Sie den Wert der $PROFILE Variablen an. Sie können die $PROFILE Variable auch in einem Befehl verwenden, um einen Pfad darzustellen.

Die $PROFILE Variable speichert den Pfad zum Profil "Aktueller Benutzer, aktueller Host". Die anderen Profile werden in Notizeigenschaften der $PROFILE Variablen gespeichert.

Die Variable weist beispielsweise $PROFILE die folgenden Werte in der Windows PowerShell-Konsole auf.

  • Aktueller Benutzer, aktueller Host - $PROFILE
  • Aktueller Benutzer, aktueller Host - $PROFILE.CurrentUserCurrentHost
  • Aktueller Benutzer, alle Hosts - $PROFILE.CurrentUserAllHosts
  • Alle Benutzer, aktueller Host - $PROFILE.AllUsersCurrentHost
  • Alle Benutzer, alle Hosts - $PROFILE.AllUsersAllHosts

Da sich die Werte der $PROFILE Variablen für jeden Benutzer und in jeder Hostanwendung ändern, stellen Sie sicher, dass Sie die Werte der Profilvariablen in jeder verwendeten PowerShell-Hostanwendung anzeigen.

Geben Sie Folgendes ein, um die aktuellen Werte der $PROFILE Variablen anzuzeigen:

$PROFILE | Select-Object *

Sie können die $PROFILE Variable in vielen Befehlen verwenden. Beispielsweise öffnet der folgende Befehl das Profil "Aktueller Benutzer, aktueller Host" in Editor:

notepad $PROFILE

Der folgende Befehl bestimmt, ob auf dem lokalen Computer ein Profil "Alle Benutzer, alle Hosts" erstellt wurde:

Test-Path -Path $PROFILE.AllUsersAllHosts

Erstellen eines Profils

Verwenden Sie zum Erstellen eines PowerShell-Profils das folgende Befehlsformat:

if (!(Test-Path -Path <profile-name>)) {
  New-Item -ItemType File -Path <profile-name> -Force
}

Verwenden Sie beispielsweise den folgenden Befehl, um ein Profil für den aktuellen Benutzer in der aktuellen PowerShell-Hostanwendung zu erstellen:

if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
}

In diesem Befehl verhindert die if Anweisung, dass Sie ein vorhandenes Profil überschreiben. Ersetzen Sie den Wert der $PROFILE Variablen durch den Pfad zur Profildatei, die Sie erstellen möchten.

Hinweis

Um "Alle Benutzer"-Profile in Windows Vista und höheren Versionen von Windows zu erstellen, starten Sie PowerShell mit der Option "Als Administrator ausführen".

So bearbeiten Sie ein Profil

Sie können ein beliebiges PowerShell-Profil in einem Text-Editor öffnen, z. B. Editor.

Um das Profil des aktuellen Benutzers in der aktuellen PowerShell-Hostanwendung in Editor zu öffnen, geben Sie Folgendes ein:

notepad $PROFILE

Um andere Profile zu öffnen, geben Sie den Profilnamen an. Um beispielsweise das Profil für alle Benutzer aller Hostanwendungen zu öffnen, geben Sie Folgendes ein:

notepad $PROFILE.AllUsersAllHosts

Um die Änderungen anzuwenden, speichern Sie die Profildatei, und starten Sie PowerShell neu.

Auswählen eines Profils

Wenn Sie mehrere Hostanwendungen verwenden, fügen Sie die Elemente, die Sie in allen Hostanwendungen verwenden, in Ihr $PROFILE.CurrentUserAllHosts Profil ein. Platzieren Sie Elemente, die spezifisch für eine Hostanwendung sind, z. B. einen Befehl, der die Hintergrundfarbe für eine Hostanwendung festlegt, in einem Profil, das für diese Hostanwendung spezifisch ist.

Wenn Sie ein Administrator sind, der PowerShell für viele Benutzer angepasst, befolgen Sie die folgenden Richtlinien:

  • Speichern der allgemeinen Elemente im $PROFILE.AllUsersAllHosts Profil
  • Speichern von Elementen, die für eine Hostanwendung spezifisch sind, in $PROFILE.AllUsersCurrentHost Profilen, die für die Hostanwendung spezifisch sind
  • Speichern von Elementen für bestimmte Benutzer in den benutzerspezifischen Profilen

Überprüfen Sie unbedingt die Hostanwendungsdokumentation auf eine spezielle Implementierung von PowerShell-Profilen.

Verwenden eines Profils

Viele der Elemente, die Sie in PowerShell erstellen, und die meisten Befehle, die Sie ausführen, wirken sich nur auf die aktuelle Sitzung aus. Wenn Sie die Sitzung beenden, werden die Elemente gelöscht.

Zu den sitzungsspezifischen Befehlen und Elementen gehören PowerShell-Variablen, Umgebungsvariablen, Aliase, Funktionen, Befehle und PowerShell-Module, die Sie der Sitzung hinzufügen.

Um diese Elemente zu speichern und in allen zukünftigen Sitzungen verfügbar zu machen, fügen Sie sie einem PowerShell-Profil hinzu.

Eine weitere häufige Verwendung für Profile besteht darin, häufig verwendete Funktionen, Aliase und Variablen zu speichern. Wenn Sie die Elemente in einem Profil speichern, können Sie sie in jeder anwendbaren Sitzung verwenden, ohne sie neu zu erstellen.

So starten Sie ein Profil

Wenn Sie die Profildatei öffnen, ist sie leer. Sie können sie jedoch mit den Variablen, Aliasen und Befehlen ausfüllen, die Sie häufig verwenden.

Hier sind einige Vorschläge, die Ihnen den Einstieg erleichtern.

Hinzufügen einer Funktion, die Aliase für jedes Cmdlet auflistet

function Get-CmdletAlias ($cmdletname) {
  Get-Alias |
    Where-Object -FilterScript {$_.Definition -like "$cmdletname"} |
      Format-Table -Property Definition, Name -AutoSize
}

Anpassen der Konsole

function CustomizeConsole {
  $hosttime = (Get-ChildItem -Path $PSHOME\pwsh.exe).CreationTime
  $hostversion="$($Host.Version.Major)`.$($Host.Version.Minor)"
  $Host.UI.RawUI.WindowTitle = "PowerShell $hostversion ($hosttime)"
  Clear-Host
}
CustomizeConsole

Hinzufügen einer benutzerdefinierten PowerShell-Eingabeaufforderung

function Prompt {
    $env:COMPUTERNAME + "\" + (Get-Location) + "> "
}

Weitere Informationen zur PowerShell-Eingabeaufforderung finden Sie unter about_Prompts.

Weitere Profilbeispiele finden Sie unter Anpassen der Shellumgebung.

Der Parameter "NoProfile"

Um PowerShell ohne Profile zu starten, verwenden Sie den NoProfile-Parameter des pwsh.exeProgramms, das PowerShell startet.

Öffnen Sie zunächst ein Programm, das PowerShell starten kann, z. B. Cmd.exe oder PowerShell selbst. Sie können auch das Dialogfeld "Ausführen" in Windows verwenden.

Typ:

pwsh -NoProfile

Eine vollständige Liste der Parameter von pwsh.exe, typ:

pwsh -?

Profile und Ausführungsrichtlinie

Die PowerShell-Ausführungsrichtlinie bestimmt teilweise, ob Sie Skripts ausführen und Konfigurationsdateien laden können, einschließlich der Profile. Die Richtlinie für die eingeschränkte Ausführung ist die Standardeinstellung. Es verhindert, dass alle Skripts ausgeführt werden, einschließlich der Profile. Wenn Sie die Richtlinie "Eingeschränkt" verwenden, wird das Profil nicht ausgeführt, und der Inhalt wird nicht angewendet.

Ein Set-ExecutionPolicy Befehl legt ihre Ausführungsrichtlinie fest und ändert sie. Es handelt sich um einen der wenigen Befehle, die in allen PowerShell-Sitzungen gelten, da der Wert in der Registrierung gespeichert wird. Sie müssen sie nicht festlegen, wenn Sie die Konsole öffnen, und Sie müssen keinen Befehl in Ihrem Profil speichern Set-ExecutionPolicy .

Profile und Remotesitzungen

PowerShell-Profile werden in Remotesitzungen nicht automatisch ausgeführt, sodass die Befehle, die die Profile hinzufügen, in der Remotesitzung nicht vorhanden sind. Darüber hinaus wird die $PROFILE automatische Variable in Remotesitzungen nicht aufgefüllt.

Verwenden Sie zum Ausführen eines Profils in einer Sitzung das Cmdlet Invoke-Command .

Mit dem folgenden Befehl wird beispielsweise das Profil "Aktueller Benutzer, Aktueller Host" vom lokalen Computer in der Sitzung in der Sitzung $sausgeführt.

Invoke-Command -Session $s -FilePath $PROFILE

Mit dem folgenden Befehl wird das Profil "Aktueller Benutzer, aktueller Host" vom Remotecomputer in der Sitzung in $sder Sitzung ausgeführt. Da die $PROFILE Variable nicht aufgefüllt wird, verwendet der Befehl den expliziten Pfad zum Profil. Wir verwenden dot sourcing operator so, dass das Profil im aktuellen Bereich auf dem Remotecomputer und nicht in seinem eigenen Bereich ausgeführt wird.

Invoke-Command -Session $s -ScriptBlock {
  . "$HOME\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1"
}

Nach dem Ausführen dieses Befehls stehen die Befehle, die das Profil der Sitzung hinzufügt, in $s.

Weitere Informationen