Partager via


Get-PSSessionConfiguration

Obtient les configurations de session inscrites sur l'ordinateur.

Syntaxe

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

Description

L'applet de commande Get-PSSessionConfiguration obtient les configurations de session inscrites sur l'ordinateur local. Il s'agit d'une applet de commande avancée, conçue pour être employée par les administrateurs système pour la gestion des configurations de session personnalisées des utilisateurs.

Pour créer et inscrire une configuration de session, utilisez l'applet de commande Register-PSSessionConfiguration.

Paramètres

-Name <string[]>

Obtient uniquement les configurations de session correspondant au nom ou modèle de nom spécifié. Entrez un ou plusieurs noms de configuration de session. Les caractères génériques sont autorisés.

Obligatoire ?

false

Position ?

1

Valeur par défaut

All session configurations on the local computer

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

true

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

Aucun

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Sorties

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration

Remarques

Pour exécuter cette applet de commande sur Windows Vista, Windows Server 2008 et les versions ultérieures de Windows, vous devez ouvrir Windows PowerShell avec l'option Exécuter en tant qu'administrateur.

Vous devez être membre du groupe Administrateurs sur l'ordinateur où vous souhaitez afficher les configurations de session.

Pour que vous puissiez exécuter une commande Get-PSSessionConfiguration sur un ordinateur distant, l'authentification CredSSP (Credential Security Service Provider) doit être activée dans les paramètres du client de l'ordinateur local (par le biais de l'applet de commande Enable-WSManCredSSP) et dans les paramètres de service de l'ordinateur distant : par ailleurs, vous devez utiliser la valeur CredSSP du paramètre Authentication lors de l'établissement de la session à distance. Sinon, l'accès est refusé.

Exemple 1

C:\PS>get-pssessionconfiguration

Description
-----------
Cette commande obtient les configurations de session sur l'ordinateur.





Exemple 2

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

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

Description
-----------
Cette commande utilise le paramètre Name de Get-PSSessionConfiguration pour obtenir uniquement les configurations de session dont les noms commencent par « Microsoft ».

Cette commande obtient les deux configurations de session par défaut fournies avec Windows PowerShell.





Exemple 3

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

Description
-----------
Ces commandes examinent l'objet PSSessionConfiguration retourné par Get-PSSessionConfiguration.

La première commande utilise l'applet de commande Get-PSSessionConfiguration pour obtenir la configuration par défaut Microsoft.PowerShell.

La deuxième commande utilise un opérateur de pipeline (|) pour envoyer l'objet retourné par Get-PSSessionConfiguration à l'applet de commande Get-Member. La sortie indique les propriétés et méthodes de l'objet.

La troisième commande envoie le même objet à l'applet de commande Format-List. Le paramètre Property utilisé avec la valeur * (tous) demande à Format-List d'afficher toutes les propriétés et valeurs de propriétés de l'objet dans une liste.

La sortie de cette commande fournit des informations très utiles, notamment l'emplacement du fichier .dll qui implémente le type de configuration, l'URI (Uniform Resource Identifier) de ressource du point de terminaison créé et la valeur SDDL (Security Descriptor Definition Language) de la configuration.





Exemple 4

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}

Description
-----------
Cette commande utilise l'applet de commande Get-ChildItem (alias = dir) dans le lecteur de fournisseur WSMan: pour examiner le contenu du nœud Plugin.

C'est une autre façon de consulter les configurations de session sur l'ordinateur.

Le nœud Plugin contient les objets ContainerElement (Microsoft.WSMan.Management.WSManConfigContainerElement) qui représentent les configurations de session Windows PowerShell inscrites, ainsi que les autres plug-ins du service Gestion des services Web.





Exemple 5

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

Description
-----------
Cet exemple indique comment exécuter une commande Get-PSSessionConfiguration sur un ordinateur distant. La commande requiert que la délégation CredSSP soit activée dans les paramètres du client de l'ordinateur local et dans les paramètres de service de l'ordinateur distant. Pour exécuter les commandes de cet exemple, vous devez être membre du groupe Administrateurs sur l'ordinateur local et l'ordinateur distant.

La première commande utilise l'applet de commande Enable-WSManCredSSP pour activer la délégation CredSSP à partir de l'ordinateur local Server01 sur l'ordinateur distant Server02. Le paramètre du client CredSSP est ainsi configuré sur l'ordinateur local.

La deuxième commande utilise l'applet de commande Connect-WSMan pour se connecter à l'ordinateur Server02. Cette action ajoute un nœud pour l'ordinateur Server02 au lecteur WSMan: de l'ordinateur local, vous permettant d'afficher et de modifier les paramètres du service Gestion des services Web sur l'ordinateur Server02.

La troisième commande utilise l'applet de commande Set-Item pour redéfinir la valeur de l'élément CredSSP dans le nœud Service de l'ordinateur Server02 sur True. Les paramètres de service sont ainsi configurés sur l'ordinateur distant.

La quatrième commande utilise l'applet de commande Invoke-Command pour exécuter une commande Get-PSSessionConfiguration sur l'ordinateur Server02. La commande utilise le paramètre Credential, ainsi que le paramètre Authentication avec la valeur CredSSP.





Exemple 6

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

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

Description
-----------
Cette commande utilise l'applet de commande Get-PSSessionConfiguration pour obtenir l'URI de ressource d'une configuration de session. 

Cette commande est utile lors de la définition de la valeur de la variable de préférence $PSSessionConfigurationName, qui accepte un URI de ressource. 

La variable $PSSessionConfigurationName spécifie la configuration par défaut utilisée lorsque vous créez une session. Cette variable est définie sur l'ordinateur local, mais spécifie une configuration sur l'ordinateur distant. Pour plus d'informations sur la variable $PSSessionConfiguration, consultez about_Preference_Variables.





Voir aussi

Concepts

about_Session_Configurations
Disable-PSSessionConfiguration
Enable-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration
WSMan Provider