Get-PSSessionConfiguration

Lekéri a regisztrált munkamenet-konfigurációkat a számítógépen.

Syntax

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

Description

A Get-PSSessionConfiguration parancsmag lekéri a helyi számítógépen regisztrált munkamenet-konfigurációkat. Ez egy speciális parancsmag, amelyet a rendszergazdák arra terveztek, hogy egyéni munkamenet-konfigurációkat kezeljenek a felhasználók számára.

A PowerShell 3.0-tól kezdve a munkamenet-konfiguráció tulajdonságait egy munkamenet-konfigurációs (.pssc) fájllal határozhatja meg. Ez a funkció lehetővé teszi testreszabott és korlátozott munkamenetek létrehozását számítógépes program írása nélkül. A munkamenet-konfigurációs fájlokkal kapcsolatos további információkért lásd about_Session_Configuration_Files.

Emellett a PowerShell 3.0-tól kezdve új megjegyzéstulajdonságok lettek hozzáadva a visszaadott munkamenet-konfigurációs objektumhoz Get-PSSessionConfiguration . Ezek a tulajdonságok megkönnyítik a felhasználók és a munkamenet-konfigurációk szerzői számára a munkamenet-konfigurációk vizsgálatát és összehasonlítását.

Munkamenet-konfiguráció létrehozásához és regisztrálásához használja a Register-PSSessionConfiguration parancsmagot. A munkamenet-konfigurációkkal kapcsolatos további tudnivalókért tekintse meg az about_Session_Configuration_Files című témakört.

Példák

1. példa – Munkamenet-konfigurációk lekérése a helyi számítógépen

Get-PSSessionConfiguration

2. példa – A két alapértelmezett munkamenet-konfiguráció lekérése

A parancs a Name paraméterrel Get-PSSessionConfiguration csak a "Microsoft" kezdetű munkamenet-konfigurációk lekérésére használja.

Get-PSSessionConfiguration -Name Microsoft*

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

3. példa – Munkamenet-konfiguráció tulajdonságainak és értékeinek lekérése

Ez a példa egy munkamenet-konfigurációs fájllal létrehozott munkamenet-konfiguráció tulajdonságait és tulajdonságértékét mutatja be.

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                    :

A példa a Get-PSSessionConfiguration parancsmagot használja a teljes munkamenet-konfiguráció lekéréséhez. A folyamatkezelő elküldi a teljes munkamenet-konfigurációt a Format-List parancsmagnak. Az ( összes) értékkel rendelkező Tulajdonság paraméter az objektum összes tulajdonságának * és értékének megjelenítésére van Format-List állítva egy listában.

A kimenet hasznos információkat tartalmaz, többek között a munkamenet-konfiguráció szerzőjével, az ezzel a munkamenet-konfigurációval létrehozott munkamenetek munkamenettípusát, nyelvi módját és végrehajtási szabályzatát, a munkamenet-kvótákat és a munkamenet-konfigurációs fájl teljes elérési útját.

A munkamenet-konfiguráció ezen nézete munkamenetkonfigurációs fájlt tartalmazó munkamenetekhez használható. A munkamenet-konfigurációs fájlokkal kapcsolatos további információkért lásd about_Session_Configuration_Files.

4. példa – A munkamenet-konfigurációk másik módja

Ez a példa a Get-ChildItem WSMan: szolgáltatói meghajtó parancsmagját (aliasát dir) használja a Beépülő modul csomópont tartalmának megtekintéséhez. Ez egy másik módszer a számítógép munkamenet-konfigurációinak megtekintésére.

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

A PlugIn-csomópontcontainerElement objektumokat (Microsoft.WSMan.Management.WSManConfigContainerElement) tartalmaz, amelyek a regisztrált PowerShell-munkamenetkonfigurációkat, valamint a WS-Management egyéb beépülő moduljait képviselik.

6. példa – Munkamenet-konfigurációk megtekintése távoli számítógépen

Ez a példa bemutatja, hogyan használható a WSMan-szolgáltató a távoli számítógépen futó munkamenet-konfigurációk megtekintésére. Ez a metódus nem nyújt annyi információt, mint egy Get-PSSessionConfiguration parancs, de a parancsmag futtatásához a felhasználónak nem kell a Rendszergazdák csoport tagjának lennie.

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

A Connect-WSMan parancsmag csatlakozik a WinRM szolgáltatáshoz a Server01 távoli számítógépen. A Get-ChildItem WSMan: meghajtó parancsmagja (aliasa dir) lekéri a Server01\Plugin elérési út elemeit. A kimenet a Server01 számítógép Beépülő modul könyvtárában lévő elemeket jeleníti meg. Az elemek közé tartoznak a munkamenet-konfigurációk, amelyek a WSMan beépülő modulok egy típusa, valamint a számítógép egyéb beépülő moduljai.

7. példa – Részletes munkamenet-konfigurációk lekérése távoli számítógépről

Ez a példa bemutatja, hogyan futtathat parancsokat Get-PSSessionConfiguration egy távoli számítógépen. A parancs megköveteli, hogy a CredSSP-delegálás engedélyezve legyen a helyi számítógép ügyfélbeállításaiban és a távoli számítógépen található szolgáltatásbeállításokban.

A példában szereplő parancsok futtatásához a helyi és távoli számítógépek Rendszergazdák csoportjának tagjának kell lennie, és a PowerShellt a Futtatás rendszergazdaként beállítással kell elindítania.

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

A Enable-WSManCredSSP parancsmag engedélyezi a CredSSP delegálást a Server01-en, a helyi számítógépen. A Connect-WSMan parancsmag a Server02 számítógéphez csatlakozik. Ez a művelet hozzáad egy Server02-csomópontot a WSMan: meghajtóhoz a helyi számítógépen, így megtekintheti és módosíthatja a WS-Management beállításait a Server02 számítógépen. A Set-Item parancsmag a Server02 számítógép Szolgáltatás csomópontjában lévő CredSSP elem értékét Igaz értékre módosítja. Ezzel konfigurálja a szolgáltatás beállításait a távoli számítógépen. A Invoke-Command parancsmag futtatja aGet-PSSessionConfiguration parancsot a Server02 számítógépen. A parancs a Hitelesítő adatok paramétert használja, és a Hitelesítési paramétert credSSP értékkel használja. A kimenet a Server02 távoli számítógépén található munkamenet-konfigurációkat jeleníti meg.

8. példa – Munkamenet-konfiguráció erőforrás-URI-jának lekérése

Ez a példa hasznos a beállítási változó értékének $PSSessionConfigurationName beállításához, amely erőforrás-URI-t vesz igénybe.

(Get-PSSessionConfiguration -Name CustomShell).resourceURI

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

A $PSSessionConfigurationName változó megadja a munkamenet létrehozásakor használt alapértelmezett konfigurációt. Ez a változó a helyi számítógépen van beállítva, de a távoli számítógépen megadja a konfigurációt. A változóval kapcsolatos további információkért lásd about_Preference_Variables.$PSSessionConfiguration

Paraméterek

-Force

Letiltja a WinRM szolgáltatás újraindítására vonatkozó kérést, ha a szolgáltatás még nem fut.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Csak a megadott névvel vagy névmintával rendelkező munkamenet-konfigurációkat kapja meg. Adjon meg egy vagy több munkamenet-konfigurációnevet. Helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:0
Default value:All session configurations on the local computer
Accept pipeline input:False
Accept wildcard characters:True

Bevitelek

None

Ehhez a parancsmaghoz nem lehet bemenő csövet adni.

Kimenetek

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Jegyzetek

  • A parancsmag futtatásához indítsa el a PowerShellt a Futtatás rendszergazdaként beállítással.

  • A számítógép munkamenet-konfigurációinak megtekintéséhez a számítógépen a Rendszergazdák csoport tagjának kell lennie.

  • Ha távoli számítógépen szeretne parancsot futtatni Get-PSSessionConfiguration , engedélyeznie kell a Hitelesítőadat-biztonsági szolgáltató (CredSSP) hitelesítését a helyi számítógépen (a Enable-WSManCredSSP parancsmag használatával) és a távoli számítógépen található szolgáltatásbeállításokban. Emellett a távoli munkamenet létrehozásakor a hitelesítési paraméter CredSSP-értékét kell használnia. Ellenkező esetben a hozzáférés megtagadva.

  • A visszaadott objektum Get-PSSessionConfiguration jegyzettulajdonságai csak akkor jelennek meg az objektumon, ha értékük van. Csak a munkamenet-konfigurációs fájllal létrehozott munkamenet-konfigurációk rendelkeznek az összes definiált tulajdonsággal.

  • A munkamenet-konfigurációs objektumok tulajdonságai a munkamenet-konfiguráció beállításaitól és a beállítások értékeitől függően változnak. Emellett a munkamenet-konfigurációs fájlt használó munkamenet-konfigurációk további tulajdonságokkal rendelkeznek.

  • A WSMan: meghajtó parancsaival módosíthatja a munkamenet-konfigurációk tulajdonságait. A PowerShell 2.0-ban azonban nem használhatja a WSMan: meghajtót a PowerShell 3.0-ban bevezetett munkamenet-konfigurációs tulajdonságok, például az OutputBufferingMode módosításához. A PowerShell 2.0-parancsok nem okoznak hibát, de hatástalanok. A PowerShell 3.0-ban bevezetett tulajdonságok módosításához használja a WSMan: meghajtót a PowerShell 3.0-ban.