Get-PSSessionConfiguration

  • Referencia
Modul:
Microsoft.PowerShell.Core

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 a felhasználók testreszabott munkamenet-konfigurációinak kezelésére terveztek.

A PowerShell 3.0-tól kezdve a munkamenet-konfiguráció tulajdonságait egy munkamenet-konfigurációs (.pssc) fájl használatával határozhatja meg. Ezzel a funkcióval egyéni és korlátozott munkameneteket hozhat létre számítógépprogram írása nélkül. További információ a munkamenet-konfigurációs fájlokról: about_Session_Configuration_Files.

Emellett a PowerShell 3.0-tól kezdve új jegyzettulajdonsá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 Név paraméterrel Get-PSSessionConfiguration csak a "Microsoft" kezdetű neveket tartalmazó 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 munkamenetkonfigurá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. A (mind) értékkel * rendelkező tulajdonságparaméter az Format-List objektum összes tulajdonságát és értékét egy listában jeleníti meg.

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 munkamenetkvótákat és a munkamenet-konfigurációs fájl teljes elérési útját.

Ez a munkamenetkonfiguráció nézete munkamenetkonfigurációs fájlt tartalmazó munkamenetekhez használható. További információ a munkamenet-konfigurációs fájlokról: about_Session_Configuration_Files.

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

Ez a példa a Get-ChildItem WSMan: provider drive parancsmagot (alias 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ópont containerElement 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álhatja a WSMan-szolgáltatót a távoli számítógépen futó munkamenet-konfigurációk megtekintéséhez. 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 Rendszergazda istrators 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 (aliasadir) a Server01\Beépülő modul elérési útjának elemeit kapja meg. A kimenet a Server01 számítógépen található Beépülő modul könyvtár elemeit jeleníti meg. Az elemek közé tartoznak a munkamenet-konfigurációk, amelyek A WSMan beépülő modul 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 parancshoz engedélyezni kell a CredSSP-delegálást a helyi számítógépen lévő ügyfélbeállításokban é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épeken a Rendszergazda istrators csoport 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ását 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 csomópontot a Server02-hez 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áscsomópontjában lévő CredSSP elem értékét Igaz értékre módosítja. Ez 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ő 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épen 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 az erőforrás URI-ját $PSSessionConfigurationName jelölő beállításához hasznos.

(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: $PSSessionConfiguration about_Preference_Variables.

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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

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 Rendszergazda istrators csoport tagjának kell lennie a számítógépen.

  • Ha távoli számítógépen szeretne parancsot futtatni Get-PSSessionConfiguration , engedélyezni kell a Credential Security Service Provider (CredSSP) hitelesítést 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. A távoli munkamenet létrehozásakor a hitelesítési paraméter CredSSP-értékét is használnia kell. 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ékétől függően változnak. Emellett a munkamenet-konfigurációs fájlt használó munkamenet-konfigurációk további tulajdonságokkal is 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 munkamenetkonfigurá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.