about_Windows_PowerShell_Compatibility

  • Artykuł

Krótki opis

Opisuje funkcje zgodności programu Windows PowerShell dla programu PowerShell 7.

Długi opis

Jeśli manifest modułu nie wskazuje, że moduł jest zgodny z programem PowerShell Core, moduły w %windir%\system32\WindowsPowerShell\v1.0\Modules folderze są ładowane w tle w procesie środowiska Windows PowerShell 5.1 przez funkcję zgodności programu Windows PowerShell.

Korzystanie z funkcji zgodność

Po zaimportowaniu pierwszego modułu przy użyciu funkcji zgodności programu Windows PowerShell program PowerShell tworzy sesję zdalną o nazwie WinPSCompatSession uruchomionej w tle procesu programu Windows PowerShell 5.1. Ten proces jest tworzony, gdy funkcja Zgodność importuje pierwszy moduł. Proces jest zamykany po usunięciu ostatniego takiego modułu (przy użyciu Remove-Modulepolecenia ) lub zakończeniu procesu programu PowerShell.

Moduły załadowane w sesji są używane za pośrednictwem niejawnej komunikacji zdalnej WinPSCompatSession i odzwierciedlane w bieżącej sesji programu PowerShell. Jest to ta sama metoda transportu używana dla zadań programu PowerShell.

Po zaimportowaniu modułu WinPSCompatSession do sesji niejawna komunikacja zdalna generuje moduł proxy w katalogu użytkownika $env:Temp i importuje ten moduł proxy do bieżącej sesji programu PowerShell. Dzięki temu program PowerShell może wykryć, że moduł został załadowany przy użyciu funkcji zgodności programu Windows PowerShell.

Po utworzeniu sesji można jej użyć do operacji, które nie działają poprawnie na obiektach deserializowanych. Cały potok jest wykonywany w programie Windows PowerShell i zwracany jest tylko wynik końcowy. Na przykład:

$s = Get-PSSession -Name WinPSCompatSession
Invoke-Command -Session $s -ScriptBlock {
  "Running in Windows PowerShell version $($PSVersionTable.PSVersion)"
}

Funkcję Zgodności można wywołać na dwa sposoby:

  • Jawnie przez zaimportowanie modułu przy użyciu parametru UseWindowsPowerShell

    Import-Module -Name ScheduledTasks -UseWindowsPowerShell

  • Niejawnie przez zaimportowanie modułu programu Windows PowerShell według nazwy modułu, ścieżki lub automatycznego ładowania za pomocą odnajdywania poleceń.

    Import-Module -Name ServerManager
Get-AppLockerPolicy -Local

    Jeśli moduł AppLocker nie został jeszcze załadowany, zostanie załadowany automatycznie po uruchomieniu polecenia Get-AppLockerPolicy.

Zgodność programu Windows PowerShell blokuje ładowanie modułów wymienionych w ustawieniu w WindowsPowerShellCompatibilityModuleDenyList pliku konfiguracji programu PowerShell.

Wartość domyślna tego ustawienia to:

"WindowsPowerShellCompatibilityModuleDenyList":  [
   "PSScheduledJob","BestPractices","UpdateServices"
]

Zarządzanie ładowaniem niejawnego modułu

Aby wyłączyć niejawne zachowanie importowania funkcji zgodności programu Windows PowerShell, użyj DisableImplicitWinCompat ustawienia w pliku konfiguracji programu PowerShell. To ustawienie można dodać do powershell.config.json pliku. Aby uzyskać więcej informacji, zobacz about_powershell_config.

W tym przykładzie pokazano, jak utworzyć plik konfiguracji, który wyłącza niejawną funkcję ładowania modułu zgodności programu Windows PowerShell.

$ConfigPath = "$PSHOME\DisableWinCompat.powershell.config.json"
$ConfigJSON = ConvertTo-Json -InputObject @{
  "DisableImplicitWinCompat" = $true
  "Microsoft.PowerShell:ExecutionPolicy" = "RemoteSigned"
}
$ConfigJSON | Out-File -Force $ConfigPath
pwsh -settingsFile $ConfigPath

Aby uzyskać więcej informacji na temat zgodności modułów, zobacz listę zgodności modułów programu PowerShell 7.

Zarządzanie klonowaniem poleceń cmdlet

Funkcja zgodności programu Windows PowerShell używa niejawnej komunikacji zdalnej do ładowania modułów w trybie zgodności. Wynikiem jest to, że polecenia wyeksportowane przez moduł mają pierwszeństwo przed poleceniami o tej samej nazwie w bieżącej sesji programu PowerShell 7. W wersji programu PowerShell 7.0.0 zawiera to podstawowe moduły dostarczane za pomocą programu PowerShell.

W programie PowerShell 7.1 zachowanie zostało zmienione tak, aby następujące podstawowe moduły programu PowerShell nie były klonowane:

  • Microsoft.PowerShell.ConsoleHost
  • Microsoft.PowerShell.Diagnostics
  • Microsoft.PowerShell.Host
  • Microsoft.PowerShell.Management
  • Microsoft.PowerShell.Security
  • Microsoft.PowerShell.Utility
  • Microsoft.WSMan.Management

Program PowerShell 7.1 dodał również możliwość wyświetlania listy dodatkowych modułów, które nie powinny być clobbered przez tryb zgodności.

Możesz dodać WindowsPowerShellCompatibilityNoClobberModuleList ustawienie do pliku konfiguracji programu PowerShell. Wartość tego ustawienia to rozdzielona przecinkami lista nazw modułów. Wartość domyślna tego ustawienia to:

"WindowsPowerShellCompatibilityNoClobberModuleList": [ ]

Ograniczenia

Funkcja zgodności programu Windows PowerShell:

  1. Działa tylko lokalnie na komputerach z systemem Windows
  2. Wymaga programu Windows PowerShell 5.1
  3. Działa na serializowanych parametrach polecenia cmdlet i zwracanych wartościach, a nie na obiektach na żywo
  4. Wszystkie moduły zaimportowane do sesji komunikacji zdalnej programu Windows PowerShell współużytkują tę samą przestrzeń uruchamiania.

Słowa kluczowe

about_Windows_PowerShell_Compatibility

Zobacz też