Get-PSSessionConfiguration

  • Reference
Modul:
Microsoft.PowerShell.Core

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

Syntax

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

K vytvoření a registraci konfigurace 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 pomocí parametru Get-PSSessionConfiguration Name získá pouze konfigurace relací s názvy, které 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 kanálu odešle do rutiny konfiguraci Format-List úplné relace. Parametr Property s hodnotou * (všechny) směruje 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 relací najdete 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 poskytovatele 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 relace PowerShellu spolu s dalšími 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 Správa istrators 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) wsMan: jednotka 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 Get-PSSessionConfiguration příkaz 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.

Chcete-li spustit příkazy v tomto příkladu, musíte být členem skupiny Správa istrators 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-WSManCredSSPpovolí delegování CredSSP na serveru Server01, 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í služby WS-Management na počítači Server02. Rutina změní hodnotu položky CredSSP v uzlu Služby počítače Server02 na Hodnotu True.Set-Item Tím se nakonfiguruje nastavení služby ve vzdáleném počítači. Rutina Invoke-Command spustíGet-PSSessionConfiguration příkaz 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 $PSSessionConfigurationName proměnné předvolby, 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ž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 $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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Vstupy

None

Do této rutiny nemůžete roušit objekty.

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 Správa istrators v počítači.

  • Pokud chcete spustit Get-PSSessionConfiguration příkaz na vzdáleném počítači, musí být v nastavení klienta v místním počítači (pomocí Enable-WSManCredSSP rutiny) 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 vytváření 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 se 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.