Sdílet prostřednictvím

Get-PSSessionConfiguration

  • Reference
Modul:
Microsoft.PowerShell.Core

Získá registrované konfigurace relace v počítači.

Syntaxe

Get-PSSessionConfiguration
   [[-Name] <String[]>]
   [-Force]
   [<CommonParameters>]

Description

Rutina Get-PSSessionConfiguration získá konfigurace relací zaregistrované v místním počítači. Jedná se o pokročilou rutinu, která je navržená tak, aby je správci systému používali ke správě přizpůsobených konfigurací relací pro své uživatele.

Počínaje PowerShellem 3.0 můžete definovat vlastnosti konfigurace relace pomocí souboru konfigurace relace (.pssc). Tato funkce umožňuje vytvářet přizpůsobené a omezené relace bez psaní počítačového programu. Další informace o konfiguračních souborech relace naleznete v tématu about_Session_Configuration_Files.

Počínaje PowerShellem 3.0 byly také přidány nové vlastnosti poznámek do objektu konfigurace relace, který Get-PSSessionConfiguration vrací. Tyto vlastnosti usnadňují uživatelům a autorům konfigurace relací prozkoumání a porovnání konfigurací relací.

K vytvoření a registraci konfigurace relace použijte rutinu Register-PSSessionConfiguration. Další informace o konfiguracích relací najdete v tématu about_Session_Configurations.

Příklady

Příklad 1 – Získání konfigurací relací na místním počítači

Get-PSSessionConfiguration

Příklad 2 – Získání dvou výchozích konfigurací relací

Příkaz používá parametr NameGet-PSSessionConfiguration k získání pouze konfigurace relací s názvy začínajícími na "Microsoft".

Get-PSSessionConfiguration -Name Microsoft*

Name                      PSVersion  StartupScript        Permission
----                      ---------  -------------        ----------
microsoft.powershell      5.1                             BUILTIN\Administrators AccessAll...
microsoft.powershell32    5.1                             BUILTIN\Administrators AccessAll...

Příklad 3 – Získání vlastností a hodnot konfigurace relace

Tento příklad ukazuje vlastnosti a hodnoty vlastností konfigurace relace vytvořené pomocí konfiguračního souboru relace.

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                    :

Příklad používá rutinu Get-PSSessionConfiguration k získání úplné konfigurace relace. Operátor kanálu odešle konfiguraci úplné relace do rutiny Format-List. Vlastnost parametr s hodnotou * (všechny) směruje Format-List k zobrazení všech vlastností a hodnot objektu v seznamu.

Výstup obsahuje užitečné informace, včetně autora konfigurace relace, typu relace, režimu jazyka a zásad spouštění relací vytvořených s touto konfigurací relace, kvótami relací a úplnou cestou k konfiguračnímu souboru relace.

Toto zobrazení konfigurace relace se používá pro relace, které obsahují konfigurační soubor relace. Další informace o konfiguračních souborech relace naleznete v tématu about_Session_Configuration_Files.

Příklad 4 – Jiný způsob, jak se podívat na konfigurace relací

Tento příklad používá rutinu Get-ChildItem (alias dir) v jednotce zprostředkovatele WSMan k zobrazení obsahu uzlu modulu plug-in. Toto je další způsob, jak se podívat na konfigurace relací v počítači.

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

Uzel PlugIn obsahuje objekty ContainerElement (Microsoft.WSMan.Management.WSManConfigContainerElement), které představují registrované konfigurace relací PowerShellu a další moduly plug-in pro WS-Management.

Příklad 6 – Zobrazení konfigurací relací ve vzdáleném počítači

Tento příklad ukazuje, jak pomocí zprostředkovatele WSMan zobrazit konfigurace relace ve vzdáleném počítači. Tato metoda neposkytuje tolik informací jako Get-PSSessionConfiguration příkaz, ale uživatel nemusí být členem skupiny Administrators ke spuštění této rutiny.

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

Rutina Connect-WSMan se připojí ke službě WinRM na vzdáleném počítači Serveru01. Rutina Get-ChildItem (alias dir) jednotky WSMan: získá položky v cestě Server01\Plugin. Výstup zobrazuje položky v adresáři pluginu na počítači Server01. Položky zahrnují konfigurace relací, které jsou typem modulu plug-in WSMan, spolu s dalšími typy modulů plug-in v počítači.

Příklad 7 – Získání podrobných konfigurací relací ze vzdáleného počítače

Tento příklad ukazuje, jak spustit příkaz Get-PSSessionConfiguration na vzdáleném počítači. Příkaz vyžaduje povolení delegování CredSSP v nastavení klienta na místním počítači a v nastavení služby na vzdáleném počítači.

Pokud chcete příkazy spustit v tomto příkladu, musíte být členem skupiny Administrators na místních a vzdálených počítačích a musíte spustit PowerShell s možností Spustit jako správce.

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

Rutina Enable-WSManCredSSP umožňuje delegování CredSSP na serveru Server01 v místním počítači. Rutina Connect-WSMan se připojí k počítači se serverem Server02. Tato akce přidá uzel pro Server02 do jednotky WSMan: na místním počítači, což umožňuje zobrazit a změnit nastavení WS-Management na počítači Server02. Rutina Set-Item změní hodnotu položky CredSSP v uzlu služby počítače Server02 na True. Tím se nakonfiguruje nastavení služby ve vzdáleném počítači. Rutina Invoke-Command spustí příkazGet-PSSessionConfiguration na počítači se serverem 02. Příkaz používá parametr credential a používá parametr Authentication s hodnotou CredSSP. Výstup ukazuje konfigurace relací na vzdáleném počítači Se serverem 02.

Příklad 8 – Získání identifikátoru URI prostředku konfigurace relace

Tento příklad je užitečný pro nastavení hodnoty proměnné předvolby $PSSessionConfigurationName, která přebírá identifikátor URI prostředku.

(Get-PSSessionConfiguration -Name CustomShell).resourceURI

https://schemas.microsoft.com/powershell/microsoft.CustomShell

Proměnná $PSSessionConfigurationName určuje výchozí konfiguraci, která se použije při vytváření relace. Tato proměnná je nastavena na místním počítači, ale určuje konfiguraci na vzdáleném počítači. Další informace o proměnné $PSSessionConfiguration naleznete v tématu about_Preference_Variables.

Parametry

-Force

Potlačí výzvu k restartování služby WinRM, pokud služba ještě není spuštěná.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Získá pouze konfigurace relace se zadaným názvem nebo vzorem názvu. Zadejte jeden nebo více názvů konfigurací relací. Jsou povoleny zástupné cardy.

Typ:String[]
Position:0
Default value:All session configurations on the local computer
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Poznámky

  • Pokud chcete tuto rutinu spustit, spusťte PowerShell s možností Spustit jako správce.

  • Chcete-li zobrazit konfigurace relací v počítači, musíte být členem skupiny Administrators v počítači.

  • Pokud chcete spustit příkaz Get-PSSessionConfiguration na vzdáleném počítači, musí být v nastavení klienta na místním počítači (pomocí rutiny Enable-WSManCredSSP) a v nastavení služby na vzdáleném počítači povolené ověřování zprostředkovatele služby Credential Security Service Provider (CredSSP). Při navazování vzdálené relace musíte také použít hodnotu CredSSP parametru Authentication. V opačném případě se přístup odepře.

  • Vlastnosti poznámky objektu, který Get-PSSessionConfiguration vrátí, se zobrazí na objektu pouze tehdy, když mají hodnotu. Všechny definované vlastnosti mají pouze konfigurace relací vytvořené pomocí konfiguračního souboru relace.

  • Vlastnosti objektu konfigurace relace se liší podle možností nastavených pro konfiguraci relace a hodnot těchto možností. Konfigurace relací, které používají konfigurační soubor relace, mají také další vlastnosti.

  • Pomocí příkazů ve WSMan: jednotce můžete změnit vlastnosti konfigurací relací. Nelze však použít WSMan: jednotka v PowerShellu 2.0 ke změně vlastností konfigurace relace, které jsou zavedeny v PowerShellu 3.0, například OutputBufferingMode. Příkazy PowerShellu 2.0 negenerují chybu, ale jsou neefektivní. Pokud chcete změnit vlastnosti zavedené v PowerShellu 3.0, použijte jednotku WSMan: v PowerShellu 3.0.