Удаленное взаимодействие PowerShell: управление целевой версией (PowerShell Core или Windows PowerShell); состояние кроссплатформенного удаленного взаимодействия

• Часть Microsoft.PowerShell относится к (64-битной) конфигурации сеанса Windows PowerShell, как указано в Get-PSSessionConfiguration (в нижнем регистре).

• Префикс http://schemas.microsoft.com/powershell/ является необязательным и может быть опущен; обратите внимание, что использование https: в префиксе не работает и не автоматически переключается на транспорт на основе SSL; для последнего требуется явная конфигурация. Обратите внимание, что удаленное взаимодействие на основе HTTPS / SSL не требуется, если все ваше удаленное взаимодействие происходит в домене Windows.

Чтобы настроить таргетинг на PowerShell Core (PowerShell v6 +) на удаленном компьютере:

• Как правило, конфигурации сеанса PowerShell Core зависят от версии, и у вас есть два варианта:

  • Настройте таргетинг на основную версию PowerShell Core - например, PowerShell.7 - используя последнюю версию v7.x, установленную на целевой машине.

    • This is preferable, because your code then doesn't require updating every time you install a patch or minor version update on the target machine.

  • Настройте таргетинг на конкретную версию - например, PowerShell.7.1.2

    • Do this only if you have multiple, side-by-side installations that share the same major version, and you explicitly need to target one of them.

  • Опять же, запуск Get-PSSessionConfiguration на целевой машине из сеанса с повышенными правами сообщает вам имена всех зарегистрированных конфигураций сеанса.

• Чтобы настроить таргетинг на PowerShell Core ad hoc, используйте -ConfigurationName PowerShell.7, например:

# Connect to computer $comp and make it execute $PSVersionTable 
# in PowerShell Core v7.x, which tells you what PowerShell edition 
# and version is running.
Invoke-Command -ComputerName $comp -ConfigurationName PowerShell.7 { $PSVersionTable }

• Чтобы настроить таргетинг на PowerShell Core по умолчанию постоянно с заданного клиентского компьютера, добавьте в свой $PROFILE файл что-то вроде следующего:

# When remoting, default to running PowerShell Core v7.x on the
# the target machines:
$PSSessionConfigurationName = 'PowerShell.7'

• Чтобы все клиенты данного удаленного сервера компьютера были нацелены на PowerShell Core по умолчанию, постоянно, вы должны переопределить microsoft.powershell конфигурацию сеанса сервера, для чего требуются права администратора; вы можете адаптировать следующий фрагмент:

# Run WITH ELEVATION (as administrator) and
# ONLY IF YOU UNDERSTAND THE IMPLICATIONS.

$ErrorActionPreference = 'Stop'

# The configuration whose definition you want to make the new default.
$newDefaultConfigSource = 'PowerShell.7'

# Standard registry locations and names.
$defaultConfigName = 'Microsoft.PowerShell'
$configXmlValueName = 'ConfigXml'
$configRootKey = 'registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\WSMAN\Plugin'

# Rename the current default configuration XML to "ConfigXml.OLD" to keep a backup.
Rename-ItemProperty $configRootKey\$defaultConfigName $configXmlValueName -NewName "$configXmlValueName.OLD"

# Get the configuration XML from the configuration that should become the new default.
# Modify it to replace the source configuration name with the default configuration name.
$xmlText = (Get-ItemPropertyValue $configRootKey\$newDefaultConfigSource $configXmlValueName) -replace 
             ('\b{0}\b' -f [regex]::Escape($newDefaultConfigSource)), $defaultConfigName

# Save the modified XML as the default configuration's config XML.
Set-ItemProperty $configRootKey\$defaultConfigName $configXmlValueName $xmlText

# Restart the WinRM service for changes to take effect.
Restart-Service WinRM