about_Profiles

Artykuł
03/18/2024

Krótki opis

Opisuje sposób tworzenia i używania profilu programu PowerShell.

Długi opis

Możesz utworzyć profil programu PowerShell, aby dostosować środowisko i dodać elementy specyficzne dla sesji do każdej uruchomionej sesji programu PowerShell.

Profil programu PowerShell to skrypt uruchamiany po uruchomieniu programu PowerShell. Możesz użyć profilu jako skryptu uruchamiania, aby dostosować środowisko. Możesz dodawać polecenia, aliasy, funkcje, zmienne, moduły, dyski programu PowerShell i nie tylko. Możesz również dodać inne elementy specyficzne dla sesji do profilu, aby były dostępne w każdej sesji bez konieczności importowania lub ponownego tworzenia.

Program PowerShell obsługuje kilka profilów dla użytkowników i programów hostów. Nie tworzy jednak profilów.

Typy profilów i lokalizacje

Program PowerShell obsługuje kilka plików profilów, które są ograniczone do użytkowników i hostów programu PowerShell. Możesz mieć dowolny lub wszystkie te profile na komputerze.

Konsola programu PowerShell obsługuje następujące podstawowe pliki profilów. Te ścieżki plików są lokalizacjami domyślnymi.

Wszyscy użytkownicy, wszystkie hosty
- Windows — $PSHOME\Profile.ps1
- Linux — /opt/microsoft/powershell/7/profile.ps1
- macOS — /usr/local/microsoft/powershell/7/profile.ps1
Wszyscy użytkownicy, bieżący 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
Bieżący użytkownik, wszystkie hosty
- Windows — $HOME\Documents\PowerShell\Profile.ps1
- Linux — ~/.config/powershell/profile.ps1
- macOS — ~/.config/powershell/profile.ps1
Bieżący użytkownik, bieżący host
- Windows — $HOME\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
- Linux — ~/.config/powershell/Microsoft.PowerShell_profile.ps1
- macOS — ~/.config/powershell/Microsoft.PowerShell_profile.ps1

Uwaga

W systemie Windows lokalizację Documents folderu można zmienić za pomocą przekierowania folderu lub usługi OneDrive. Nie zalecamy przekierowywania folderu do udziału sieciowego ani dołączania Documents go do usługi OneDrive. Przekierowanie folderu może spowodować niepowodzenie ładowania modułów i utworzenie błędów w skryptach profilu. Aby uzyskać informacje na temat usuwania Documents folderu z zarządzania usługą OneDrive, zapoznaj się z dokumentacją usługi OneDrive.

Skrypty profilu są wykonywane w podanej kolejności. Oznacza to, że zmiany wprowadzone w profilu AllUsersAllHosts mogą zostać zastąpione przez dowolny z innych skryptów profilu. Profil CurrentUserCurrentHost zawsze jest uruchamiany jako ostatni. W Pomocy programu PowerShell profil CurrentUserCurrentHost jest najczęściej określany jako profil programu PowerShell.

Inne programy obsługujące program PowerShell mogą obsługiwać własne profile. Na przykład program Visual Studio Code (VS Code) obsługuje następujące profile specyficzne dla hosta.

Wszyscy użytkownicy, bieżący host — $PSHOME\Microsoft.VSCode_profile.ps1
Bieżący użytkownik, bieżący host — $HOME\Documents\PowerShell\Microsoft.VSCode_profile.ps1

Ścieżki profilu obejmują następujące zmienne:

Zmienna $PSHOME przechowuje katalog instalacyjny programu PowerShell
Zmienna $HOME przechowuje katalog główny bieżącego użytkownika

Zmienna $PROFILE

Zmienna automatyczna $PROFILE przechowuje ścieżki do profilów programu PowerShell, które są dostępne w bieżącej sesji.

Aby wyświetlić ścieżkę profilu, wyświetl wartość zmiennej $PROFILE . Możesz również użyć zmiennej $PROFILE w poleceniu, aby reprezentować ścieżkę.

Zmienna $PROFILE przechowuje ścieżkę do profilu "Bieżący użytkownik, bieżący host". Inne profile są zapisywane we właściwościach notatek zmiennej $PROFILE .

Na przykład zmienna $PROFILE ma następujące wartości w konsoli programu Windows PowerShell.

Bieżący użytkownik, bieżący host — $PROFILE
Bieżący użytkownik, bieżący host — $PROFILE.CurrentUserCurrentHost
Bieżący użytkownik, wszystkie hosty — $PROFILE.CurrentUserAllHosts
Wszyscy użytkownicy, bieżący host — $PROFILE.AllUsersCurrentHost
Wszyscy użytkownicy, wszyscy hosty — $PROFILE.AllUsersAllHosts

Ponieważ wartości $PROFILE zmiennej zmieniają się dla każdego użytkownika i w każdej aplikacji hosta, upewnij się, że wartości zmiennych profilu są wyświetlane w każdej używanej aplikacji hosta programu PowerShell.

Aby wyświetlić bieżące wartości zmiennej $PROFILE , wpisz:

$PROFILE | Select-Object *

Można użyć zmiennej $PROFILE w wielu poleceniach. Na przykład następujące polecenie otwiera profil "Bieżący użytkownik, bieżący host" w Notatnik:

notepad $PROFILE

Następujące polecenie określa, czy na komputerze lokalnym został utworzony profil "Wszyscy użytkownicy, wszystkie hosty":

Test-Path -Path $PROFILE.AllUsersAllHosts

Jak utworzyć profil

Aby utworzyć profil programu PowerShell, użyj następującego formatu polecenia:

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

Aby na przykład utworzyć profil bieżącego użytkownika w bieżącej aplikacji hosta programu PowerShell, użyj następującego polecenia:

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

W tym poleceniu if instrukcja uniemożliwia zastąpienie istniejącego profilu. Zastąp wartość zmiennej $PROFILE ścieżką do pliku profilu, który chcesz utworzyć.

Uwaga

Aby utworzyć profile "Wszyscy użytkownicy" w systemie Windows Vista i nowszych wersjach systemu Windows, uruchom program PowerShell z opcją Uruchom jako administrator .

Jak edytować profil

Możesz otworzyć dowolny profil programu PowerShell w edytorze tekstów, na przykład Notatnik.

Aby otworzyć profil bieżącego użytkownika w bieżącej aplikacji hosta programu PowerShell w Notatnik, wpisz:

notepad $PROFILE

Aby otworzyć inne profile, określ nazwę profilu. Aby na przykład otworzyć profil dla wszystkich użytkowników wszystkich aplikacji hosta, wpisz:

notepad $PROFILE.AllUsersAllHosts

Aby zastosować zmiany, zapisz plik profilu, a następnie uruchom ponownie program PowerShell.

Jak wybrać profil

Jeśli używasz wielu aplikacji hosta, umieść elementy używane we wszystkich aplikacjach hosta w profilu $PROFILE.CurrentUserAllHosts . Umieść elementy specyficzne dla aplikacji hosta, takie jak polecenie, które ustawia kolor tła dla aplikacji hosta, w profilu specyficznym dla tej aplikacji hosta.

Jeśli jesteś administratorem, który dostosowuje program PowerShell dla wielu użytkowników, postępuj zgodnie z następującymi wytycznymi:

Przechowywanie typowych elementów w $PROFILE.AllUsersAllHosts profilu
Przechowuj elementy specyficzne dla aplikacji hosta w $PROFILE.AllUsersCurrentHost profilach specyficznych dla aplikacji hosta
Przechowywanie elementów dla konkretnych użytkowników w profilach specyficznych dla użytkownika

Pamiętaj, aby zapoznać się z dokumentacją aplikacji hosta pod kątem dowolnej specjalnej implementacji profilów programu PowerShell.

Jak używać profilu

Wiele elementów utworzonych w programie PowerShell i większość uruchamianych poleceń ma wpływ tylko na bieżącą sesję. Po zakończeniu sesji elementy zostaną usunięte.

Polecenia i elementy specyficzne dla sesji obejmują zmienne programu PowerShell, zmienne środowiskowe, aliasy, funkcje, polecenia i moduły programu PowerShell dodawane do sesji.

Aby zapisać te elementy i udostępnić je we wszystkich przyszłych sesjach, dodaj je do profilu programu PowerShell.

Innym typowym zastosowaniem profilów jest zapisywanie często używanych funkcji, aliasów i zmiennych. Podczas zapisywania elementów w profilu można ich używać w dowolnej odpowiedniej sesji bez ich ponownego tworzenia.

Jak uruchomić profil

Po otwarciu pliku profilu jest on pusty. Można jednak wypełnić je zmiennymi, aliasami i poleceniami, których często używasz.

Poniżej przedstawiono kilka sugestii, które ułatwiają rozpoczęcie pracy.

Dodawanie funkcji, która wyświetla aliasy dla dowolnego polecenia cmdlet

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

Dostosowywanie konsoli

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

Dodawanie dostosowanego monitu programu PowerShell

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

Aby uzyskać więcej informacji na temat wiersza polecenia programu PowerShell, zobacz about_Prompts.

Aby zapoznać się z innymi przykładami profilów, zobacz Dostosowywanie środowiska powłoki.

Parametr NoProfile

Aby uruchomić program PowerShell bez profilów, użyj parametru pwsh.exeNoProfile programu , który uruchamia program PowerShell.

Aby rozpocząć, otwórz program, który może uruchomić program PowerShell, taki jak Cmd.exe lub sam program PowerShell. Można również użyć okna dialogowego Uruchamianie w systemie Windows.

Typ:

pwsh -NoProfile

Aby uzyskać pełną listę parametrów typu pwsh.exe, wpisz:

pwsh -?

Profile i zasady wykonywania

Zasady wykonywania programu PowerShell określają częściowo, czy można uruchamiać skrypty i ładować pliki konfiguracji, w tym profile. Zasady wykonywania z ograniczeniami są domyślne. Uniemożliwia uruchamianie wszystkich skryptów, w tym profilów. Jeśli używasz zasad "Ograniczone", profil nie zostanie uruchomiony, a jego zawartość nie zostanie zastosowana.

Polecenie Set-ExecutionPolicy ustawia i zmienia zasady wykonywania. jest to jedno z niewielu poleceń, które mają zastosowanie we wszystkich sesjach programu PowerShell, ponieważ wartość jest zapisywana w rejestrze. Nie musisz go ustawiać po otwarciu konsoli i nie musisz przechowywać Set-ExecutionPolicy polecenia w profilu.

Profile i sesje zdalne

Profile programu PowerShell nie są uruchamiane automatycznie w sesjach zdalnych, więc polecenia dodane przez profile nie są obecne w sesji zdalnej. Ponadto zmienna automatyczna $PROFILE nie jest wypełniana w sesjach zdalnych.

Aby uruchomić profil w sesji, użyj polecenia cmdlet Invoke-Command .

Na przykład następujące polecenie uruchamia profil "Bieżący użytkownik, bieżący host" z komputera lokalnego w sesji w $sprogramie .

Invoke-Command -Session $s -FilePath $PROFILE

Następujące polecenie uruchamia profil "Bieżący użytkownik, bieżący host" z komputera zdalnego w sesji w $sprogramie . Ponieważ zmienna $PROFILE nie jest wypełniana, polecenie używa jawnej ścieżki do profilu. Używamy operatora określania kropki, aby profil był wykonywany w bieżącym zakresie na komputerze zdalnym, a nie w jego własnym zakresie.

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

Po uruchomieniu tego polecenia polecenia, które profil dodaje do sesji, są dostępne w pliku $s.