Sdílet prostřednictvím

Get-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

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

Syntax

Default (Výchozí) 

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čilý cmdlet navržený pro správce 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 vám umožňuje vytvářet přizpůsobená a omezená sezení, aniž byste museli psát počítačový program. Další informace o konfiguračních souborech relace naleznete v tématu about_Session_Configuration_Files.

Od začátku PowerShellu 3.0 byly do objektu konfigurace relace, který vrací Get-PSSessionConfiguration, přidány nové poznámkové vlastnosti. 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í naleznete v části 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 Name z Get-PSSessionConfiguration k získání pouze těch konfigurací relací, jejichž názvy začínají 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                   : 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 potrubí odešle konfiguraci kompletní relace do rutiny Format-List cmdlet. Parametr vlastnosti s hodnotou * (vše) přikazuje Format-List zobrazit všechny vlastnosti a hodnoty 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 přihrádce poskytovatele WSMan pro zobrazení obsahu uzlu modulu Plugin. 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í na 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řipojuje ke službě WinRM na vzdáleném počítači Server01. Příkaz Get-ChildItem (alias dir) jednotky WSMan: získává 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 druhem plug-inu WSMan, spolu s dalšími typy plug-inů na 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. Cmdlet Connect-WSMan se připojí k počítači Server02. Tato akce přidá uzel pro Server02 na disk 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 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 Server02.

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

Tento příklad je užitečný pro nastavení hodnoty preference proměnné $PSSessionConfigurationName, která používá 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ž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á.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

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

Vlastnosti parametru

Typ:

String[]

Default value:All session configurations on the local computer
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

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). Také musíte při navazování vzdálené relace 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í. Avšak nelze použít WSMan: pohon ve PowerShellu 2.0 ke změně vlastností konfigurace relace, které jsou zavedeny v PowerShellu 3.0, jako například OutputBufferingMode. Příkazy PowerShellu 2.0 negenerují chybu, ale jsou neefektivní. Chcete-li změnit vlastnosti zavedené ve verzi PowerShell 3.0, použijte v tomto prostředí jednotku WSMan:.