Get-PSSessionConfiguration

Získá zaregistrované konfigurace relací v počítači.

Syntax

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

Description

Rutina Get-PSSessionConfiguration získá konfigurace relací zaregistrovaných v místním počítači. Jedná se o pokročilou rutinu, která je navržená tak, aby ji používali správci systému 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 relací najdete v tématu about_Session_Configuration_Files.

Od PowerShellu 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í zkoumání a porovnání konfigurací relací.

Pokud chcete vytvořit a zaregistrovat konfiguraci relace, použijte rutinu Register-PSSessionConfiguration . Další informace o konfiguracích relace 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 Get-PSSessionConfigurationName k získání pouze konfigurací relací s názvy, které začínají "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                   : http://schemas.microsoft.com/powershell/Full
MaxConcurrentCommandsPerShell : 1500
UseSharedProcess              : false
ProcessIdleTimeoutSec         : 0
xmlns                         : http://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 do rutiny konfiguraci Format-List úplné relace. Parametr Vlastnost s hodnotou * (všechny) směruje Format-List 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 relací najdete v tématu about_Session_Configuration_Files.

Příklad 4 – Další 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 plug-in. To 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 spolu s dalšími moduly plug-in pro WS-Management.

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

Tento příklad ukazuje, jak pomocí zprostředkovatele WSMan zobrazit konfigurace relací na 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 plug-in na počítači Server01. Mezi položky patří 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 Get-PSSessionConfiguration příkaz na vzdáleném počítači. Příkaz vyžaduje, aby bylo delegování CredSSP povolené 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

Tato Enable-WSManCredSSP rutina povolí delegování CredSSP na serveru Server01, místním počítači. Rutina Connect-WSMan se připojí k počítači Server02. Tato akce přidá uzel pro Server02 do wsMan: jednotka na místním počítači, která 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 na vzdáleném počítači. Rutina Invoke-CommandGet-PSSessionConfiguration spustí příkaz na počítači Server02. 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 Serveru02.

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

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

(Get-PSSessionConfiguration -Name CustomShell).resourceURI

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

Proměnná $PSSessionConfigurationName určuje výchozí konfiguraci, která se používá při vytváření relace. Tato proměnná je nastavená na místním počítači, ale určuje konfiguraci vzdáleného počítače. Další informace o $PSSessionConfiguration proměnné najdete 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á.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:0
Default value:All session configurations on the local computer
Accept pipeline input:False
Accept wildcard characters: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 .

  • Pokud chcete zobrazit konfigurace relací v počítači, musíte být členem skupiny Administrators na počítači.

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

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

  • Vlastnosti objektu konfigurace relace se liší s možnostmi nastavenými pro konfiguraci relace a hodnotami 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.