Informationen zu Profilen
Kurze Beschreibung
Beschreibt das Erstellen und Verwenden eines PowerShell-Profils.
Lange Beschreibung
Sie können ein PowerShell-Profil erstellen, um Ihre Umgebung anzupassen und um sitzungsspezifische Elemente zu jeder gestarteten PowerShell-Sitzung hinzuzufügen.
Ein PowerShell-Profil ist ein Skript, das ausgeführt wird, wenn PowerShell gestartet wird. Sie können das Profil als Anmeldeskript verwenden, um die Umgebung anzupassen. Sie können Befehle, Aliase, Funktionen, Variablen, Snap-Ins, Module und PowerShell-Laufwerke hinzufügen. Sie können Ihrem Profil auch andere sitzungsspezifische Elemente hinzufügen, sodass sie in jeder Sitzung verfügbar sind, ohne sie importieren oder neu erstellen zu müssen.
PowerShell unterstützt mehrere Profile für Benutzer und Hostprogramme. Die Profile werden jedoch nicht für Sie erstellt. In diesem Thema werden die Profile und das Erstellen und Verwalten von Profilen auf Ihrem Computer beschrieben.
Es wird erläutert, wie Sie den NoProfile-Parameter der PowerShell-Konsole (PowerShell.exe) verwenden, um PowerShell ohne Profile zu starten. Außerdem werden die Auswirkungen der PowerShell-Ausführungsrichtlinie auf Profile erläutert.
Profildateien
PowerShell unterstützt mehrere Profildateien. Außerdem können PowerShell-Hostprogramme ihre eigenen hostspezifischen Profile unterstützen.
Beispielsweise unterstützt die PowerShell-Konsole die folgenden grundlegenden Profildateien. Die Profile werden in Rangfolge aufgeführt. Das erste Profil hat die höchste Priorität.
| BESCHREIBUNG | `Path` |
|---|---|
| Alle Benutzer, alle Hosts | $PSHOME\Profile.ps1 |
| Alle Benutzer, aktueller Host | $PSHOME\Microsoft.PowerShell_profile.ps1 |
| Aktueller Benutzer, alle Hosts | $Home\[Mein ]Documents\PowerShell\Profile.ps1 |
| Aktueller Benutzer, Aktueller Host | $Home\[Meine ]Dokumente\PowerShell\ Microsoft.PowerShell_profile.ps1 |
Die Profilpfade enthalten die folgenden Variablen:
- Die
$PSHOMEVariable, die das Installationsverzeichnis für PowerShell speichert - Die
$HomeVariable, die das Basisverzeichnis des aktuellen Benutzers speichert
Darüber hinaus können andere Programme, die PowerShell hosten, ihre eigenen Profile unterstützen. Visual Studio Code unterstützt beispielsweise die folgenden hostspezifischen Profile.
| BESCHREIBUNG | `Path` |
|---|---|
| Alle Benutzer, Aktueller Host | $PSHOME\Microsoft.VSCode_profile.ps1 |
| Aktueller Benutzer, Aktueller Host | $Home\[Meine ]Dokumente\PowerShell\ Microsoft.VSCode_profile.ps1 |
In der PowerShell-Hilfe ist das Profil "CurrentUser, Current Host" das Profil, das am häufigsten als "Ihr PowerShell-Profil" bezeichnet wird.
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 Variablen an $PROFILE . 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 den Eigenschaften der $PROFILE Variablen gespeichert.
Die Variable verfügt beispielsweise $PROFILE über die folgenden Werte in der Windows PowerShell-Konsole.
| BESCHREIBUNG | Name |
|---|---|
| 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 jede 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 | Get-Member -Type NoteProperty
Sie können die $PROFILE Variable in vielen Befehlen verwenden. Mit dem folgenden Befehl wird beispielsweise das Profil "Aktueller Benutzer, aktueller Host" in Editor geöffnet:
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 des <Profilpfadplatzhalters> durch den Pfad zur Profildatei, die Sie erstellen möchten.
Hinweis
Um Profile "Alle Benutzer" in Windows Vista und höheren Versionen von Windows zu erstellen, starten Sie PowerShell mit der Option Als Administrator ausführen .
Bearbeiten eines Profils
Sie können jedes PowerShell-Profil in einem Text-Editor öffnen, z. B. Editor.
Geben Sie Folgendes ein, um das Profil des aktuellen Benutzers in der aktuellen PowerShell-Hostanwendung in Editor zu öffnen:
notepad $PROFILE
Um andere Profile zu öffnen, geben Sie den Profilnamen an. Geben Sie beispielsweise Folgendes ein, um das Profil für alle Benutzer aller Hostanwendungen zu öffnen:
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 für eine Hostanwendung spezifisch 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 hat, befolgen Sie die folgenden Richtlinien:
- Speichern der allgemeinen Elemente im
$PROFILE.AllUsersAllHostsProfil - Speichern von Elementen, die für eine Hostanwendung spezifisch sind, in
$PROFILE.AllUsersCurrentHostProfilen, die für die Hostanwendung spezifisch sind - Speichern von Elementen für bestimmte Benutzer in den benutzerspezifischen Profilen
Überprüfen Sie die Dokumentation der Hostanwendung auf spezielle Implementierungen 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.
Die sitzungsspezifischen Befehle und Elemente umfassen Variablen, Einstellungsvariablen, Aliase, Funktionen, Befehle (mit Ausnahme von Set-ExecutionPolicy) 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 entsprechenden Sitzung verwenden, ohne sie neu zu erstellen.
Starten eines Profils
Wenn Sie die Profildatei öffnen, ist sie leer. Sie können es jedoch mit den Variablen, Aliasen und Befehlen füllen, die Sie häufig verwenden.
Hier finden Sie einige Vorschläge für die ersten Schritte.
Hinzufügen von Befehlen, die das Öffnen Ihres Profils vereinfachen
Dies ist besonders nützlich, wenn Sie ein anderes Profil als das Profil "Aktueller Benutzer, aktueller Host" verwenden. Fügen Sie beispielsweise den folgenden Befehl hinzu:
function Pro {notepad $PROFILE.CurrentUserAllHosts}
Hinzufügen einer Funktion, die die Aliase für alle Cmdlets auflistet
function Get-CmdletAlias ($cmdletname) {
Get-Alias |
Where-Object -FilterScript {$_.Definition -like "$cmdletname"} |
Format-Table -Property Definition, Name -AutoSize
}
Anpassen der Konsole
function Color-Console {
$Host.ui.rawui.backgroundcolor = "white"
$Host.ui.rawui.foregroundcolor = "black"
$hosttime = (Get-ChildItem -Path $PSHOME\PowerShell.exe).CreationTime
$hostversion="$($Host.Version.Major)`.$($Host.Version.Minor)"
$Host.UI.RawUI.WindowTitle = "PowerShell $hostversion ($hosttime)"
Clear-Host
}
Color-Console
Hinzufügen einer benutzerdefinierten PowerShell-Eingabeaufforderung
function Prompt
{
$env:COMPUTERNAME + "\" + (Get-Location) + "> "
}
Weitere Informationen zur PowerShell-Eingabeaufforderung finden Sie unter about_Prompts.
Der NoProfile-Parameter
Um PowerShell ohne Profile zu starten, verwenden Sie den NoProfile-Parameter von PowerShell.exe, dem Programm, 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:
PowerShell -NoProfile
Geben Sie folgendes ein, um eine vollständige Liste der Parameter von PowerShell.exe anzuzeigen:
PowerShell -?
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 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 diese. Es ist einer der wenigen Befehle, die in allen PowerShell-Sitzungen angewendet werden, da der Wert in der Registrierung gespeichert wird. Sie müssen ihn nicht festlegen, wenn Sie die Konsole öffnen, und Sie müssen keinen Set-ExecutionPolicy Befehl in Ihrem Profil speichern.
Profile und Remotesitzungen
PowerShell-Profile werden in Remotesitzungen nicht automatisch ausgeführt, sodass die von den Profilen hinzugefügten Befehle 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 in $sausgeführt.
Invoke-Command -Session $s -FilePath $PROFILE
Mit dem folgenden Befehl wird das Profil "Aktueller Benutzer, Aktueller Host" vom Remotecomputer in in ausgeführt $s. Da die $PROFILE Variable nicht aufgefüllt wird, verwendet der Befehl den expliziten Pfad zum Profil. Wir verwenden den Dot Sourcing-Operator, damit das Profil im aktuellen Bereich auf dem Remotecomputer und nicht im eigenen Bereich ausgeführt wird.
Invoke-Command -Session $s -ScriptBlock {
. "$HOME\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1"
}
Nach dem Ausführen dieses Befehls sind die Befehle, die das Profil der Sitzung hinzufügt, in $sverfügbar.