about_Session_Configuration_Files
Description courte
Décrit les fichiers de configuration de session, qui sont utilisés dans une configuration de session (également appelé « point de terminaison ») pour définir l’environnement des sessions qui utilisent la configuration de session.
Description longue
Ces informations s’appliquent uniquement à PowerShell s’exécutant sur Windows.
Un « fichier de configuration de session » est un fichier texte avec une extension de nom de fichier .pssc qui contient une table de hachage des propriétés et des valeurs de configuration de session. Vous pouvez utiliser un fichier de configuration de session pour définir les propriétés d’une configuration de session. Cela définit l’environnement de toutes les sessions PowerShell qui utilisent cette configuration de session.
Les fichiers de configuration de session facilitent la création de configurations de session personnalisées sans utiliser d’assemblys ou de scripts C# complexes.
Une « configuration de session » ou « point de terminaison » est une collection de paramètres d’ordinateur local qui déterminent des éléments tels que les utilisateurs qui peuvent créer des sessions sur l’ordinateur ; les commandes que les utilisateurs peuvent exécuter dans ces sessions ; et si la session doit s’exécuter en tant que compte virtuel privilégié. Pour plus d'informations sur les configurations de session, consultez about_Session_Configurations.
Les configurations de session ont été introduites dans Windows PowerShell 2.0 et les fichiers de configuration de session ont été introduits dans Windows PowerShell 3.0. Vous devez utiliser Windows PowerShell 3.0 pour inclure un fichier de configuration de session dans une configuration de session. Toutefois, les utilisateurs de Windows PowerShell 2.0 (et versions ultérieures) sont affectés par les paramètres de la configuration de session.
Création de sessions personnalisées
Vous pouvez personnaliser de nombreuses fonctionnalités d’une session PowerShell en spécifiant les propriétés de session dans une configuration de session. Vous pouvez personnaliser une session en écrivant un programme C# qui définit un runspace personnalisé, ou vous pouvez utiliser un fichier de configuration de session pour définir les propriétés des sessions créées à l’aide de la configuration de session. En règle générale, il est plus facile d’utiliser le fichier de configuration de session que d’écrire un programme C#.
Vous pouvez utiliser un fichier de configuration de session pour créer des éléments tels que des sessions entièrement fonctionnelles pour les utilisateurs hautement approuvés ; sessions verrouillées qui autorisent un accès minimal ; sessions conçues pour des tâches particulières et qui contiennent uniquement les modules requis pour ces tâches ; et les sessions où les utilisateurs non privilégiés ne peuvent exécuter que des commandes spécifiques en tant que compte privilégié.
En plus de cela, vous pouvez gérer si les utilisateurs de la session peuvent utiliser des éléments de langage PowerShell tels que des blocs de script ou s’ils ne peuvent exécuter que des commandes. Vous pouvez gérer la version des utilisateurs PowerShell qui peuvent s’exécuter dans la session ; gérer les modules importés dans la session ; et gérer les applets de commande, les fonctions et les alias que les utilisateurs de session peuvent exécuter. Lorsque vous utilisez le champ RoleDefinitions, vous pouvez donner aux utilisateurs différentes fonctionnalités de la session en fonction de l’appartenance au groupe.
Pour plus d’informations sur RoleDefinitions et sur la définition de cette valeur, consultez la rubrique d’aide pour l’applet de commande New-PSRoleCapabilityFile.
Création d’un fichier de configuration de session
Le moyen le plus simple de créer un fichier de configuration de session consiste à utiliser l’applet de commande New-PSSessionConfigurationFile. Cette applet de commande génère un fichier qui utilise la syntaxe et le format corrects, et qui vérifie automatiquement la plupart des valeurs de propriété du fichier de configuration.
Pour obtenir des descriptions détaillées des propriétés que vous pouvez définir dans un fichier de configuration de session, consultez la rubrique d’aide de l’applet de commande New-PSSessionConfigurationFile.
La commande suivante crée un fichier de configuration de session qui utilise les valeurs par défaut. Le fichier de configuration résultant utilise uniquement les valeurs par défaut, car aucun paramètre autre que le paramètre Path (qui spécifie le chemin d’accès du fichier) est inclus :
New-PSSessionConfigurationFile -Path .\Defaults.pssc
Pour afficher le nouveau fichier de configuration dans votre éditeur de texte par défaut, utilisez la commande suivante :
Invoke-Item -Path .\Defaults.pssc
Pour créer une configuration de session pour les sessions dans lesquelles l’utilisateur peut exécuter des commandes, mais pas utiliser d’autres éléments du langage PowerShell, tapez :
New-PSSessionConfigurationFile -LanguageMode NoLanguage
-Path .\NoLanguage.pssc
Dans la commande précédente, la définition du paramètre LanguageMode sur NoLanguage empêche les utilisateurs d’effectuer des opérations telles que l’écriture ou l’exécution de scripts ou l’utilisation de variables.
Pour créer une configuration de session pour les sessions dans lesquelles les utilisateurs peuvent utiliser uniquement des applets de commande Get, tapez :
New-PSSessionConfigurationFile -VisibleCmdlets Get-*
-Path .\GetSessions.pssc
Dans l’exemple précédent, la définition du paramètre VisibleCmdlets sur Get-* limite les utilisateurs aux applets de commande qui ont des noms qui commencent par la valeur de chaîne « Get- ».
Pour créer une configuration de session pour les sessions qui s’exécutent sous un compte virtuel privilégié au lieu des informations d’identification de l’utilisateur, tapez :
New-PSSessionConfigurationFile -RunAsVirtualAccount
-Path .\VirtualAccount.pssc
Pour créer une configuration de session pour les sessions dans lesquelles les commandes visibles par l’utilisateur sont spécifiées dans un fichier de fonctionnalités de rôle, tapez :
New-PSSessionConfigurationFile -RoleDefinitions
@{ 'CONTOSO\User' = @{ RoleCapabilities = 'Maintenance' }}
-Path .\Maintenance.pssc
Utilisation d’un fichier de configuration de session
Vous pouvez inclure un fichier de configuration de session lorsque vous créez une configuration de session ou ajoutez un fichier à la configuration de session ultérieurement.
Pour inclure un fichier de configuration de session lors de la création d’une configuration de session, utilisez le paramètre Path de l’applet de commande Register-PSSessionConfiguration.
Par exemple, la commande suivante utilise le fichier NoLanguage.pssc lorsqu’elle crée une configuration de session NoLanguage.
Register-PSSessionConfiguration -Name NoLanguage
-Path .\NoLanguage.pssc
Quand une nouvelle session NoLanguage démarre, les utilisateurs n’ont accès qu’aux commandes PowerShell.
Pour ajouter un fichier de configuration de session à une configuration de session existante, utilisez l’applet de commande Set-PSSessionConfiguration et le paramètre Path. Cela affecte les nouvelles sessions créées avec la configuration de session spécifiée. Notez que l’applet de commande Set-PSSessionConfiguration modifie la session elle-même et ne modifie pas le fichier de configuration de session.
Par exemple, la commande suivante ajoute le fichier NoLanguage.pssc à la configuration de session LockedDown.
Set-PSSessionConfiguration -Name LockedDown
-Path .\NoLanguage.pssc
Lorsque les utilisateurs utilisent la configuration de session LockedDown pour créer une session, ils pourront exécuter des applets de commande, mais ils ne pourront pas créer ou utiliser des variables, attribuer des valeurs ou utiliser d’autres éléments de langage PowerShell.
La commande suivante utilise l’applet de commande New-PSSession pour créer une session sur l’ordinateur Srv01 qui utilise la configuration de session LockedDown, en enregistrant une référence d’objet à la session dans la variable $s. La liste de contrôle d’accès (liste de contrôle d’accès) de la configuration de session détermine qui peut l’utiliser pour créer une session.
$s = New-PSSession -ComputerName Srv01
-ConfigurationName LockedDown
Étant donné que les contraintes NoLanguage ont été ajoutées à la configuration de session LockedDown, les utilisateurs des sessions LockedDown ne pourront exécuter que des commandes et des applets de commande PowerShell. Par exemple, les deux commandes suivantes utilisent l’applet de commande Invoke-Command pour exécuter des commandes dans la session référencée dans la variable $s. La première commande, qui exécute l’applet de commande Get-UICulture et n’utilise aucune variable, réussit. La deuxième commande, qui obtient la valeur de la variable $PSUICulture, échoue.
Invoke-Command -Session $s {Get-UICulture}
en-US
Invoke-Command -Session $s {$PSUICulture}
The syntax is not supported by this runspace. This might be
because it is in no-language mode.
+ CategoryInfo : ParserError: ($PSUICulture:String) [],
ParseException
+ FullyQualifiedErrorId : ScriptsNotAllowed
Modification d’un fichier de configuration de session
Tous les paramètres d’une configuration de session, à l’exception de RunAsVirtualAccount Et RunAsVirtualAccountGroups, peuvent être modifiés en modifiant le fichier de configuration de session utilisé par la configuration de session. Pour ce faire, commencez par localiser la copie active du fichier de configuration de session.
Lorsque vous utilisez un fichier de configuration de session dans une configuration de session, PowerShell crée une copie active du fichier de configuration de session et le stocke dans le répertoire $pshome\SessionConfig sur l’ordinateur local.
L’emplacement de la copie active d’un fichier de configuration de session est stocké dans la propriété ConfigFilePath de l’objet de configuration de session.
La commande suivante obtient l’emplacement du fichier de configuration de session pour la configuration de session NoLanguage.
(Get-PSSessionConfiguration -Name NoLanguage).ConfigFilePath
Cette commande retourne un chemin d’accès de fichier similaire à ce qui suit :
C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\
NoLanguage_0c115179-ff2a-4f66-a5eb-e56e5692ba22.pssc
Vous pouvez modifier le fichier .pssc dans n’importe quel éditeur de texte. Une fois le fichier enregistré, il sera utilisé par les nouvelles sessions qui utilisent la configuration de session.
Si vous devez modifier les paramètres RunAsVirtualAccount ou RunAsVirtualAccountGroups, vous devez annuler l’inscription de la configuration de session et réinscrire un fichier de configuration de session qui inclut les valeurs modifiées.
Test d’un fichier de configuration de session
Utilisez l’applet de commande Test-PSSessionConfigurationFile pour tester les fichiers de configuration de session modifiés manuellement. Cela est important : si la syntaxe et les valeurs du fichier ne sont pas valides, les utilisateurs ne pourront pas utiliser la configuration de session pour créer une session.
Par exemple, la commande suivante teste le fichier de configuration de session active de la configuration de session NoLanguage.
Test-PSSessionConfigurationFile -Path C:\WINDOWS\System32\
WindowsPowerShell\v1.0\SessionConfig\
NoLanguage_0c115179-ff2a-4f66-a5eb-e56e5692ba22.pssc
Si la syntaxe et les valeurs du fichier de configuration sont valides Test-PSSessionConfigurationFile retourne True. Si la syntaxe et les valeurs ne sont pas valides, l’applet de commande retourne False.
Vous pouvez utiliser Test-PSSessionConfigurationFile pour tester n’importe quel fichier de configuration de session, y compris les fichiers créés par l’applet de commande New-PSSessionConfiguration. Pour plus d’informations, consultez la rubrique d’aide de l’applet de commande Test-PSSessionConfigurationFile.
Suppression d’un fichier de configuration de session
Vous ne pouvez pas supprimer un fichier de configuration de session d’une configuration de session. Toutefois, vous pouvez remplacer le fichier par un nouveau fichier qui utilise les paramètres par défaut. Cela annule efficacement les paramètres utilisés par le fichier de configuration d’origine.
Pour remplacer un fichier de configuration de session, créez un fichier de configuration de session qui utilise les paramètres par défaut, puis utilisez l’applet de commande Set-PSSessionConfiguration pour remplacer le fichier de configuration de session personnalisé par le nouveau fichier.
Par exemple, les commandes suivantes créent un fichier de configuration de session par défaut, puis remplacent le fichier de configuration de session active dans la configuration de session NoLanguage.
New-PSSessionConfigurationFile -Path .\Default.pssc
Set-PSSessionConfiguration -Name NoLanguage
-Path .\Default.pssc
Lorsque ces commandes se terminent, la configuration de session NoLanguage fournit en fait une prise en charge complète de la langue (paramètre par défaut) pour toutes les sessions créées avec cette configuration de session.
Affichage des propriétés d’une configuration de session Les objets de configuration de session qui représentent des configurations de session à l’aide de fichiers de configuration de session ont des propriétés supplémentaires qui facilitent la découverte et l’analyse de la configuration de session. (Notez que le nom de type indiqué ci-dessous inclut une définition de vue mise en forme.) Vous pouvez afficher les propriétés en exécutant l’applet de commande Get-PSSessionConfiguration et en pipissant les données retournées vers l’applet de commande Get-Member :
Get-PSSessionConfiguration NoLanguage | Get-Member
TypeName: Microsoft.PowerShell.Commands.PSSessionConfigurationCommands
#PSSessionConfiguration
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.O...
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
Architecture NoteProperty System.String Archit...
Author NoteProperty System.String Author...
AutoRestart NoteProperty System.String AutoRe...
Capability NoteProperty System.Object[] Capa...
CompanyName NoteProperty System.String Compan...
configfilepath NoteProperty System.String config...
Copyright NoteProperty System.String Copyri...
Enabled NoteProperty System.String Enable...
ExactMatch NoteProperty System.String ExactM...
ExecutionPolicy NoteProperty System.String Execut...
Filename NoteProperty System.String Filena...
GUID NoteProperty System.String GUID=0...
ProcessIdleTimeoutSec NoteProperty System.String Proces...
IdleTimeoutms NoteProperty System.String IdleTi...
lang NoteProperty System.String lang=e...
LanguageMode NoteProperty System.String Langua...
MaxConcurrentCommandsPerShell NoteProperty System.String MaxCon...
MaxConcurrentUsers NoteProperty System.String MaxCon...
MaxIdleTimeoutms NoteProperty System.String MaxIdl...
MaxMemoryPerShellMB NoteProperty System.String MaxMem...
MaxProcessesPerShell NoteProperty System.String MaxPro...
MaxShells NoteProperty System.String MaxShells
MaxShellsPerUser NoteProperty System.String MaxShe...
Name NoteProperty System.String Name=N...
PSVersion NoteProperty System.String PSVersion
ResourceUri NoteProperty System.String Resour...
RunAsPassword NoteProperty System.String RunAsP...
RunAsUser NoteProperty System.String RunAsUser
SchemaVersion NoteProperty System.String Schema...
SDKVersion NoteProperty System.String SDKVer...
OutputBufferingMode NoteProperty System.String Output...
SessionType NoteProperty System.String Sessio...
UseSharedProcess NoteProperty System.String UseSha...
SupportsOptions NoteProperty System.String Suppor...
xmlns NoteProperty System.String xmlns=...
XmlRenderingType NoteProperty System.String XmlRen...
Permission ScriptProperty System.Object Permis...
Ces propriétés facilitent la recherche de configurations de session spécifiques. Par exemple, vous pouvez utiliser la propriété ExecutionPolicy pour rechercher une configuration de session qui prend en charge les sessions avec la stratégie d’exécution RemoteSigned. Notez que, étant donné que la propriété ExecutionPolicy existe uniquement sur les sessions qui utilisent des fichiers de configuration de session, la commande risque de ne pas renvoyer toutes les configurations de session éligibles.
Get-PSSessionConfiguration |
where {$_.ExecutionPolicy -eq "RemoteSigned"}
La commande suivante obtient les configurations de session dans lesquelles RunAsUser est l’administrateur Exchange.
Get-PSSessionConfiguration |
where {$_.RunAsUser -eq "Exchange01\Admin01"}
Pour afficher des informations sur les définitions de rôle associées à une configuration, utilisez l’applet de commande Get-PSSessionCapability. Cette applet de commande vous permet de déterminer les commandes et l’environnement disponibles pour des utilisateurs spécifiques dans des points de terminaison spécifiques.
Notes
Les configurations de session prennent également en charge un type de session appelé session « vide ». Un type de session vide vous permet de créer des sessions personnalisées avec des commandes sélectionnées. Si vous n’ajoutez pas de modules, de fonctions ou de scripts à une session vide, la session est limitée aux expressions et peut ne pas être d’une utilisation pratique. La propriété SessionType vous indique si vous travaillez ou non avec une session vide.
Voir aussi
- about_Session_Configurations
- New-PSRoleCapabilityFile
- New-PSSession
- Get-PSSessionCapability
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Unregister-PSSessionConfiguration
- New-PSSessionConfigurationFile
- Test-PSSessionConfigurationFile