about_Profiles

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. Profil można użyć jako skryptu logowania, aby dostosować środowisko. Można dodawać polecenia, aliasy, funkcje, zmienne, przystawki, moduły i dyski programu PowerShell. Możesz również dodać inne elementy specyficzne dla sesji do profilu, aby były dostępne w każdej sesji bez konieczności ich importowania lub ponownego tworzenia.

Program PowerShell obsługuje kilka profilów dla użytkowników i programów hostów. Jednak nie tworzy on profilów dla Ciebie. W tym temacie opisano profile i opisano sposób tworzenia i konserwacji profilów na komputerze.

W tym artykule wyjaśniono, jak użyć parametru NoProfile konsoli programu PowerShell (PowerShell.exe), aby uruchomić program PowerShell bez żadnych profilów. W tym artykule wyjaśniono wpływ zasad wykonywania programu PowerShell na profile.

Pliki profilu

Program PowerShell obsługuje kilka plików profilów. Ponadto programy hosta programu PowerShell mogą obsługiwać własne profile specyficzne dla hosta.

Na przykład konsola programu PowerShell obsługuje następujące podstawowe pliki profilów. Profile są wymienione w kolejności pierwszeństwa. Pierwszy profil ma najwyższy priorytet.

Opis Ścieżka
Wszyscy użytkownicy, wszystkie hosty Windows — $PSHOME\Profile.ps1
Linux — /usr/local/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 — /usr/local/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\[Mój ]Documents\PowerShell\Profile.ps1
Linux — ~/.config/powershell/profile.ps1
macOS — ~/.config/powershell/profile.ps1
Bieżący użytkownik, bieżący host Windows — $Home\[Mój ]Documents\PowerShell\Microsoft.PowerShell_profile.ps1
Linux — ~/.config/powershell/Microsoft.Powershell_profile.ps1
macOS — ~/.config/powershell/Microsoft.Powershell_profile.ps1

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

  • Zmienna $PSHOME , która przechowuje katalog instalacyjny programu PowerShell
  • Zmienna $Home , która przechowuje katalog główny bieżącego użytkownika

Ponadto inne programy hostujące program PowerShell mogą obsługiwać własne profile. Na przykład Visual Studio Code obsługuje następujące profile specyficzne dla hosta.

Opis Ścieżka
Wszyscy użytkownicy, bieżący host $PSHOME\Microsoft.VSCode_profile.ps1
Bieżący użytkownik, bieżący host $Home\[Moje ]Dokumenty\PowerShell\
Microsoft.VSCode_profile.ps1

W pomocy programu PowerShell profil "CurrentUser, Current Host" jest najczęściej określany jako "twój profil programu PowerShell".

Uwaga

W systemie Windows lokalizacja folderu Dokumenty może zostać zmieniona przez przekierowanie folderu lub usługę OneDrive. Nie zalecamy przekierowywania folderu Dokumenty do udziału sieciowego ani dołączania go do usługi OneDrive. Przekierowanie folderu może spowodować niepowodzenie skryptów profilu, a ładowanie modułów zakończy się niepowodzeniem.

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 Windows PowerShell.

Opis Nazwa
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, wszystkie hosty $PROFILE.AllUsersAllHosts

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

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

$PROFILE | Get-Member -Type NoteProperty

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

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 dla 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ść symbolu zastępczego <ścieżki> profilu ś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 Notatniku, 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
  • Przechowywanie elementów specyficznych dla aplikacji hosta w $PROFILE.AllUsersCurrentHost profilach specyficznych dla aplikacji hosta
  • Przechowywanie elementów dla określonych użytkowników w profilach specyficznych dla użytkownika

Upewnij się, że zapoznaj się z dokumentacją aplikacji hosta pod kątem dowolnej specjalnej implementacji profilów programu PowerShell.

Jak używać profilu

Wiele elementów tworzonych 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, zmienne preferencji, aliasy, funkcje, polecenia (z wyjątkiem polecenia Set-ExecutionPolicy) 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.

Oto kilka sugestii, które ułatwiają rozpoczęcie pracy.

Dodawanie poleceń ułatwiających otwieranie profilu

Jest to szczególnie przydatne, jeśli używasz profilu innego niż "Bieżący użytkownik, bieżący host". Dodaj na przykład następujące polecenie:

function Pro {notepad $PROFILE.CurrentUserAllHosts}

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 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

Dodawanie dostosowanego wiersza polecenia programu PowerShell

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

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

Parametr NoProfile

Aby uruchomić program PowerShell bez profilów, użyj parametru NoProfilePowerShell.exeprogramu , 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.

Wpisz:

PowerShell -NoProfile

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

PowerShell -?

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. Zapobiega on uruchamianiu 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 trzeba go ustawiać podczas otwierania konsoli i nie trzeba 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 we 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.

Zobacz też