Get-PSSessionConfiguration
Получает зарегистрированные конфигурации сеанса на компьютере.
Синтаксис
Get-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[<CommonParameters>]
Описание
Командлет Get-PSSessionConfiguration
получает конфигурации сеансов, зарегистрированные на локальном компьютере. Этот расширенный командлет предназначен для использования системными администраторами и позволяет управлять конфигурациями сеансов для пользователей.
Начиная с PowerShell 3.0, можно определить свойства конфигурации сеанса с помощью файла конфигурации сеанса (PSSC). Эта функция позволяет создавать настраиваемые и ограниченные сеансы, не создавая компьютерную программу. Дополнительные сведения о файлах конфигураций сеансов см. в разделе about_Session_Configuration_Files.
Кроме того, начиная с PowerShell 3.0 в возвращаемый объект Get-PSSessionConfiguration
конфигурации сеанса были добавлены новые свойства примечания. Эти свойства упрощают просмотр и сравнение конфигураций сеанса для пользователей и авторов конфигурации сеанса.
Чтобы создать и зарегистрировать конфигурацию сеанса, используйте Register-PSSessionConfiguration
командлет .
Дополнительные сведения о конфигурациях сеансов см. в разделе about_Session_Configurations.
Примеры
Пример 1. Получение конфигураций сеанса на локальном компьютере
Get-PSSessionConfiguration
Пример 2. Получение двух конфигураций сеанса по умолчанию
Команда использует параметр Name для Get-PSSessionConfiguration
получения только конфигураций сеанса с именами, начинающимися с "Microsoft".
Get-PSSessionConfiguration -Name Microsoft*
Name PSVersion StartupScript Permission
---- --------- ------------- ----------
microsoft.powershell 5.1 BUILTIN\Administrators AccessAll...
microsoft.powershell32 5.1 BUILTIN\Administrators AccessAll...
Пример 3. Получение свойств и значений конфигурации сеанса
В этом примере показаны свойства и значения свойств конфигурации сеанса, созданные с помощью файла конфигурации сеанса.
Get-PSSessionConfiguration -Name Full | Format-List -Property *
Copyright : (c) 2011 User01. All rights reserved.
AliasDefinitions : {System.Collections.Hashtable}
SessionType : Default
CompanyName : Unknown
GUID : 1e9cb265-dae0-4bd3-89a9-8338a47698a1
Author : User01
ExecutionPolicy : Restricted
SchemaVersion : 1.0.0.0
LanguageMode : FullLanguage
Architecture : 64
Filename : %windir%\system32\pwrshplugin.dll
ResourceUri : https://schemas.microsoft.com/powershell/Full
MaxConcurrentCommandsPerShell : 1500
UseSharedProcess : false
ProcessIdleTimeoutSec : 0
xmlns : https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
MaxConcurrentUsers : 10
lang : en-US
SupportsOptions : true
ExactMatch : true
configfilepath : C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\Full_1e9cb265-dae0-4bd3-89a9-8338a47698a1.pssc
RunAsUser :
IdleTimeoutms : 7200000
PSVersion : 3.0
OutputBufferingMode : Block
AutoRestart : false
MaxShells : 300
MaxMemoryPerShellMB : 1024
MaxIdleTimeoutms : 43200000
SDKVersion : 1
Name : Full
XmlRenderingType : text
Capability : {Shell}
RunAsPassword :
MaxProcessesPerShell : 25
Enabled : True
MaxShellsPerUser : 30
Permission :
В примере используется Get-PSSessionConfiguration
командлет для получения полной конфигурации сеанса. Оператор конвейера отправляет конфигурацию полного сеанса командлету Format-List
. Параметр Property со значением *
(all) указывает Format-List
на отображение всех свойств и значений объекта в списке.
Выходные данные содержат полезные сведения, включая автора конфигурации сеанса, тип сеанса, языковой режим и политику выполнения сеансов, созданных с этой конфигурацией сеанса, квоты сеансов и полный путь к файлу конфигурации сеанса.
Это представление конфигурации сеанса используется для сеансов, которые включают файл конфигурации сеанса. Дополнительные сведения о файлах конфигураций сеансов см. в разделе about_Session_Configuration_Files.
Пример 4. Другой способ просмотра конфигураций сеансов
В этом примере используется Get-ChildItem
командлет (псевдоним dir
) на диске поставщика WSMan: для просмотра содержимого узла Подключаемого модуля. Это еще один способ просмотра конфигураций сеанса на компьютере.
dir wsman:\localhost\plugin
Type Keys Name
---- ---- ----
Container {Name=Event Forwarding Plugin} Event Forwarding Plugin
Container {Name=Full} Full
Container {Name=microsoft.powershell} microsoft.powershell
Container {Name=microsoft.powershell.workf... microsoft.powershell.workflow
Container {Name=microsoft.powershell32} microsoft.powershell32
Container {Name=microsoft.ServerManager} microsoft.ServerManager
Container {Name=WMI Provider} WMI Provider
Узел Подключаемого модуля содержит объекты ContainerElement (Microsoft.WSMan.Management.WSManConfigContainerElement), которые представляют зарегистрированные конфигурации сеансов PowerShell, а также другие подключаемые модули для WS-Management.
Пример 6. Просмотр конфигураций сеансов на удаленном компьютере
В этом примере показано, как использовать поставщик WSMan для просмотра конфигураций сеанса на удаленном компьютере. Этот метод не предоставляет столько сведений Get-PSSessionConfiguration
, сколько команда, но для выполнения этого командлета пользователю не требуется быть членом группы Администраторы.
Connect-WSMan -ComputerName Server01
dir WSMan:\Server01\Plugin
WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin
Type Keys Name
---- ---- ----
Container {Name=Empty} Empty
Container {Name=Event Forwarding Plugin} Event Forwarding Plugin
Container {Name=Full} Full
Container {Name=microsoft.powershell} microsoft.powershell
Container {Name=microsoft.powershell.workf... microsoft.powershell.workflow
Container {Name=microsoft.powershell32} microsoft.powershell32
Container {Name=microsoft.ServerManager} microsoft.ServerManager
Container {Name=NoLanguage} NoLanguage
Container {Name=RestrictedLang} RestrictedLang
Container {Name=RRS} RRS
Container {Name=SEL Plugin} SEL Plugin
Container {Name=WithProfile} WithProfile
Container {Name=WMI Provider} WMI Provider
Командлет Connect-WSMan
подключается к службе WinRM на удаленном компьютере Server01. Командлет Get-ChildItem
(псевдоним dir
) диска WSMan: получает элементы в пути Server01\Plugin . В выходных данных показаны элементы в каталоге подключаемого модуля на компьютере Server01. Элементы включают конфигурации сеанса, которые являются типом подключаемого модуля WSMan, а также другие типы подключаемых модулей компьютера.
Пример 7. Получение подробных конфигураций сеансов с удаленного компьютера
В этом примере показано, как выполнить Get-PSSessionConfiguration
команду на удаленном компьютере. Для команды требуется включенное делегирование CredSSP в параметрах клиента на локальном компьютере и в параметрах службы на удаленном компьютере.
Чтобы выполнить команды в этом примере, необходимо быть членом группы Администраторы на локальном и удаленном компьютерах и запустить PowerShell с параметром Запуск от имени администратора .
Enable-WSManCredSSP -Delegate Server02
Connect-WSMan Server02
Set-Item WSMan:\Server02*\Service\Auth\CredSSP -Value $true
Invoke-Command -ScriptBlock {Get-PSSessionConfiguration} -ComputerName Server02 -Authentication CredSSP -Credential Domain01\Admin01
Name PSVersion StartupScript Permission PSComputerName
---- --------- ------------- ---------- --------------
microsoft.powershell 5.1 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
microsoft.powershell32 5.1 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
MyX86Shell 5.1 c:\test\x86Shell.ps1 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
Командлет Enable-WSManCredSSP
включает делегирование CredSSP на локальном компьютере Server01. Командлет Connect-WSMan
подключается к компьютеру Server02. Это действие добавляет узел для Server02 на диск WSMan: на локальном компьютере, что позволяет просматривать и изменять параметры WS-Management на компьютере Server02. Командлет Set-Item
изменяет значение элемента CredSSP в узле Служба компьютера Server02 на True. Это настраивает параметры службы на удаленном компьютере. Командлет Invoke-Command
выполняетGet-PSSessionConfiguration
команду на компьютере Server02. Команда использует параметр Credential, который использует параметр Authentication со значением CredSSP. В выходных данных показаны конфигурации сеанса на удаленном компьютере Server02.
Пример 8. Получение URI ресурса конфигурации сеанса
Этот пример полезен для задания значения переменной $PSSessionConfigurationName
предпочтения, которая принимает URI ресурса.
(Get-PSSessionConfiguration -Name CustomShell).resourceURI
https://schemas.microsoft.com/powershell/microsoft.CustomShell
Переменная $PSSessionConfigurationName
задает конфигурацию по умолчанию, которая используется при создании сеанса. Эта переменная задается на локальном компьютере, но она указывает конфигурацию на удаленном компьютере. Дополнительные сведения о переменной см. в $PSSessionConfiguration
разделе about_Preference_Variables.
Параметры
-Force
Скрывает запрос на перезапуск службы WinRM, если служба еще не запущена.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Получает только конфигурации сеанса с указанным именем или шаблоном имени. Введите одно или несколько имен конфигураций сеанса. Разрешено использовать подстановочные знаки.
Type: | String[] |
Position: | 0 |
Default value: | All session configurations on the local computer |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Входные данные
None
В этот командлет нельзя передать входные данные.
Выходные данные
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands
Примечания
Чтобы выполнить этот командлет, запустите PowerShell с параметром Запуск от имени администратора .
Чтобы просмотреть конфигурации сеанса на компьютере, необходимо быть членом группы администраторов на компьютере.
Чтобы выполнить
Get-PSSessionConfiguration
команду на удаленном компьютере, проверка подлинности поставщика службы безопасности учетных данных (CredSSP) должна быть включена в параметрах клиента на локальном компьютере (с помощью командлетаEnable-WSManCredSSP
) и в параметрах службы на удаленном компьютере. Кроме того, при установке удаленного сеанса необходимо использовать значение CredSSP параметра Authentication . В противном случае доступ будет запрещен.Свойства заметок возвращаемого
Get-PSSessionConfiguration
объекта отображаются в объекте только при наличии значения. Только конфигурации сеансов, созданные с помощью файла конфигурации сеанса, имеют все определенные свойства.Свойства объекта конфигурации сеанса зависят от заданных для конфигурации сеанса параметров и значений этих параметров. Кроме того, конфигурации сеансов, определяющие с помощью файла конфигурации, включают дополнительные свойства.
Вы можете использовать команды на диске WSMan:, чтобы изменить свойства конфигурации сеанса. Однако нельзя использовать диск WSMan: в PowerShell 2.0 для изменения свойств конфигурации сеанса, представленных в PowerShell 3.0, например OutputBufferingMode. Команды PowerShell 2.0 не создают ошибку, но неэффективны. Чтобы изменить свойства, появившиеся в PowerShell 3.0, используйте диск WSMan: в PowerShell 3.0.
Связанные ссылки
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan Provider
- about_Session_Configurations
- about_Session_Configuration_Files