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