Udostępnij za pośrednictwem

about_Windows_PowerShell_Compatibility

  • Artykuł

Krótki opis

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

Długi opis

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

Korzystanie z funkcji zgodność

Po zaimportowaniu pierwszego modułu przy użyciu funkcji zgodności Windows PowerShell program PowerShell tworzy sesję zdalną o nazwie uruchomioną WinPSCompatSession w tle Windows PowerShell 5.1 procesu. Ten proces jest tworzony, gdy funkcja Zgodności importuje pierwszy moduł. Proces jest zamykany po usunięciu ostatniego takiego modułu (przy użyciu Remove-Modulemetody ) 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 Windows PowerShell.

Po utworzeniu sesji można jej używać do operacji, które nie działają poprawnie na obiektach deserializowanych. Cały potok jest wykonywany w 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 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 jeszcze nie załadowano, moduł AppLocker zostanie automatycznie załadowany po uruchomieniu polecenia Get-AppLockerPolicy.

Windows PowerShell Zgodność 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 importu funkcji zgodności 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łów Windows PowerShell Zgodność.

$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 Windows PowerShell używa niejawnej komunikacji bezpośredniej 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ć klonowane przez tryb zgodności.

Ustawienie można dodać WindowsPowerShellCompatibilityNoClobberModuleList 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 Windows PowerShell:

  1. Działa tylko lokalnie na komputerach z systemem Windows
  2. Wymaga, aby 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 zdalnie Windows PowerShell współużytkują tę samą przestrzeń uruchamiania.

Słowa kluczowe

about_Windows_PowerShell_Compatibility

Zobacz też