Get-PSSessionConfiguration

Get-PSSessionConfiguration [[-Name] <string[]>] [<CommonParameters>]

C:\PS>get-pssessionconfiguration

Descrizione
-----------
Con questo comando si ottengono le configurazioni di sessione nel computer.

C:\PS>get-pssessionconfiguration -name Microsoft*

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

Descrizione
-----------
Questo comando utilizza il parametro Name di Get-PSSessionConfiguration per ottenere solo le configurazioni di sessione con nomi che iniziano con "Microsoft".

Con questo comando si ottengono le due configurazioni di sessione predefinite fornite con Windows PowerShell.

C:\PS>Get-PSSessionConfiguration -name microsoft.powershell | get-member



   TypeName: Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration

Name                   MemberType     Definition
----                   ----------     ----------
Equals                 Method         bool Equals(System.Object obj)
GetHashCode            Method         int GetHashCode()
GetType                Method         type GetType()
ToString               Method         string ToString()
Capability             NoteProperty   System.Object[] Capability=System.Object[]
ExactMatch             NoteProperty   System.String ExactMatch=False
Filename               NoteProperty   System.String Filename=%windir%\system32\pwrshplugin.dll
lang                   NoteProperty   System.String lang=en-US
Name                   NoteProperty   System.String Name=microsoft.powershell
PSVersion              NoteProperty   System.String PSVersion=2.0
ResourceUri            NoteProperty   System.String ResourceUri=https://schemas.microsoft.com/powershell/microsoft.powershell
SDKVersion             NoteProperty   System.String SDKVersion=1
SecurityDescriptorSddl NoteProperty   System.String SecurityDescriptorSddl=O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
SupportsOptions        NoteProperty   System.String SupportsOptions=true
Uri                    NoteProperty   System.String Uri=https://schemas.microsoft.com/powershell/microsoft.powershell
xmlns                  NoteProperty   System.String xmlns=https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
XmlRenderingType       NoteProperty   System.String XmlRenderingType=text
Permission             ScriptProperty System.Object Permission {get=trap { continue; }...


C:\PS> Get-PSSessionConfiguration -name microsoft.powershell | format-list -property *


Name                   : microsoft.powershell
Filename               : %windir%\system32\pwrshplugin.dll
SDKVersion             : 1
XmlRenderingType       : text
lang                   : en-US
PSVersion              : 2.0
ResourceUri            : https://schemas.microsoft.com/powershell/microsoft.powershell
SupportsOptions        : true
Capability             : {Shell}
Uri                    : https://schemas.microsoft.com/powershell/microsoft.powershell
SecurityDescriptorSddl : O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
ExactMatch             : False
xmlns                  : https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Permission             : BUILTIN\Administrators AccessAllowed

Descrizione
-----------
Questi comandi esaminano l'oggetto PSSessionConfiguration restituito da Get-PSSessionConfiguration.

Con il primo comando viene utilizzato il cmdlet Get-PSSessionConfiguration per ottenere la configurazione predefinita Microsoft.PowerShell.

Con il secondo comando viene utilizzato un operatore pipeline (|) per inviare l'oggetto restituito da Get-PSSessionConfiguration al cmdlet Get-Member. L'output mostra le proprietà e i metodi dell'oggetto.

Con il terzo comando viene inviato lo stesso oggetto al cmdlet Format-List. Con il parametro Property impostato sul valore * (tutti) Format-List elenca tutte le proprietà e i valori di proprietà dell'oggetto.

L'output di questo comando dispone di informazioni molto utili, inclusi il percorso del file con estensione dll che implementa il tipo di configurazione, l'URI (Uniform Resource Identifier) della risorsa per l'endpoint creato e l'SDDL (Security Descriptor Definition Language) per la configurazione.

C:\PS>dir wsman:\localhost\plugin

   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin

Name                      Type                 Keys
----                      ----                 ----
Event Forwarding Plugin   Container            {Name=Event Forwarding Plugin}
MaintenanceShell          Container            {Name=MaintenanceShell}
microsoft.powershell      Container            {Name=microsoft.powershell}
microsoft.powershell32    Container            {Name=microsoft.powershell32}
WMI Provider              Container            {Name=WMI Provider}

Descrizione
-----------
Nel comando viene utilizzato il cmdlet Get-ChildItem (alias = dir) nell'unità WSMAN: del provider per analizzare il contenuto del nodo Plugin.

Si tratta di un'altra modalità per analizzare le configurazioni di sessione nel computer.

Il nodo Plugin contiene oggetti ContainerElement (Microsoft.WSMan.Management.WSManConfigContainerElement) che rappresentano le configurazioni di sessione registrate di Windows PowerShell, insieme ad altri plug-in per WS-Management.

C:\PS>enable-wsmanCredSSP -delegate server02

C:\PS> connect-wsman server02

C:\PS> set-item wsman:\server02*\service\auth\credSSP -value $true

C:\PS> invoke-command -scriptblock {Get-PSSessionConfiguration} -computername Server02 -authentication CredSSP -credential Domain01\Admin01 

Name                      PSVersion  StartupScript        Permission                          PSComputerName
----                      ---------  -------------        ----------                          --------------
microsoft.powershell      2.0                             BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
microsoft.powershell32    2.0                             BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
MyX86Shell                2.0        c:\test\x86Shell.ps1 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com

Descrizione
-----------
In questo esempio viene illustrato come eseguire un comando Get-PSSessionConfiguration in un computer remoto. Per questo comando è necessario che la delega CredSSP sia abilitata nelle impostazioni client del computer locale e nelle impostazioni servizio nel computer remoto. Per eseguire i comandi in questo esempio, è necessario essere un membro del gruppo Administrators nel computer locale e nel computer remoto.

Con il primo comando viene utilizzato il cmdlet Enable-WSManCredSSP per abilitare la delega CredSSP dal computer locale Server01 al computer remoto Server02. L'impostazione client CredSSP viene configurata nel computer locale.

Con il secondo comando viene utilizzato il cmdlet Connect-WSMan per la connessione al computer Server02. Questa azione consente di aggiungere un nodo per il computer Server02 all'unità WSMan: nel computer locale, consentendo la visualizzazione e la modifica delle impostazioni di WS-Management nel computer Server02.

Nel terzo comando viene utilizzato il cmdlet Set-Item per modificare il valore dell'elemento CredSSP nel nodo Service del computer Server02 in True. Le impostazioni servizio vengono configurate nel computer remoto.

Con il quarto comando viene utilizzato il cmdlet Invoke-Command per eseguire un comando Get-PSSessionConfiguration nel computer Server02. Vengono utilizzati il parametro Credential e il parametro Authentication con un valore di CredSSP.

C:\PS>(get-PSSessionConfiguration -name CustomShell).resourceURI

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

Descrizione
-----------
Con questo comando viene utilizzato il cmdlet Get-PSSessionConfiguration per ottenere l'URI di risorsa di una configurazione di sessione. 

Questo comando è utile per l'impostazione del valore della variabile di preferenza $PSSessionConfigurationName che accetta un URI di risorsa. 

Con la variabile $PSSessionConfiguationName viene specificata la configurazione predefinita utilizzata quando si crea una sessione. Questa variabile viene impostata nel computer locale, ma specifica una configurazione nel computer remoto. Per ulteriori informazioni sulla variabile $PSSessionConfiguration, vedere about_Preference_Variables.