about_Session_Configuration_Files

Korte beschrijving

Beschrijft sessieconfiguratiebestanden die worden gebruikt in een sessieconfiguratie (ook wel een 'eindpunt' genoemd) voor het definiëren van de omgeving van sessies die gebruikmaken van de sessieconfiguratie.

Lange beschrijving

Een 'sessieconfiguratiebestand' is een tekstbestand met de bestandsnaamextensie .pssc dat een hashtabel bevat met sessieconfiguratie-eigenschappen en -waarden. U kunt een sessieconfiguratiebestand gebruiken om de eigenschappen van een sessieconfiguratie in te stellen. Hiermee definieert u de omgeving van powershell-sessies die gebruikmaken van die sessieconfiguratie.

Met sessieconfiguratiebestanden kunt u eenvoudig aangepaste sessieconfiguraties maken zonder complexe C#-assemblies of scripts te gebruiken.

Een 'sessieconfiguratie' of 'eindpunt' is een verzameling lokale computerinstellingen die bepalen welke gebruikers sessies op de computer kunnen maken; welke opdrachten gebruikers in die sessies kunnen uitvoeren; en of de sessie moet worden uitgevoerd als een geprivilegieerd virtueel account. Zie about_Session_Configurations (Engelstalig) voor meer informatie over sessieconfiguraties.

Sessieconfiguraties zijn geïntroduceerd in Windows PowerShell 2.0 en sessieconfiguratiebestanden zijn geïntroduceerd in Windows PowerShell 3.0. U moet Windows PowerShell 3.0 gebruiken om een sessieconfiguratiebestand op te nemen in een sessieconfiguratie. Gebruikers van Windows PowerShell 2.0 (en hoger) worden echter beïnvloed door de instellingen in de sessieconfiguratie.

Aangepaste sessies maken

U kunt veel functies van een PowerShell-sessie aanpassen door sessie-eigenschappen op te geven in een sessieconfiguratie. U kunt een sessie aanpassen door een C#-programma te schrijven dat een aangepaste runspace definieert, of u kunt een sessieconfiguratiebestand gebruiken om de eigenschappen te definiëren van sessies die zijn gemaakt met behulp van de sessieconfiguratie. Als algemene regel is het eenvoudiger om het sessieconfiguratiebestand te gebruiken dan om een C#-programma te schrijven.

U kunt een sessieconfiguratiebestand gebruiken om items te maken, zoals volledig functionerende sessies voor zeer vertrouwde gebruikers; vergrendelde sessies die minimale toegang toestaan; sessies die zijn ontworpen voor specifieke en die alleen de modules bevatten die vereist zijn voor deze taken; en sessies waarbij niet-bevoegde gebruikers alleen specifieke opdrachten kunnen uitvoeren als een bevoorrecht account.

Daarnaast kunt u beheren of gebruikers van de sessie PowerShell-taalelementen zoals scriptblokken kunnen gebruiken of dat ze alleen opdrachten kunnen uitvoeren. U kunt de versie van PowerShell-gebruikers beheren die in de sessie kunnen worden uitgevoerd. beheren welke modules worden geïmporteerd in de sessie; en beheren welke cmdlets, functies en aliassen sessiegebruikers kunnen uitvoeren. Wanneer u het veld RoleDefinitions gebruikt, kunt u gebruikers verschillende mogelijkheden geven in de sessie op basis van groepslidmaatschap.

Zie het Help-onderwerp voor de New-PSRoleCapabilityFile cmdlet voor meer informatie over RoleDefinitions en hoe u deze waarde definieert.

Een sessieconfiguratiebestand maken

De eenvoudigste manier om een sessieconfiguratiebestand te maken, is door de cmdlet New-PSSessionConfigurationFile gebruiken. Met deze cmdlet wordt een bestand gegenereerd dat de juiste syntaxis en indeling gebruikt, en dat automatisch veel van de eigenschapswaarden van het configuratiebestand verifieert.

Zie het Help-onderwerp voor de cmdlet New-PSSessionConfigurationFile voor gedetailleerde beschrijvingen van de eigenschappen die u kunt instellen in een sessieconfiguratiebestand.

Met de volgende opdracht maakt u een sessieconfiguratiebestand dat gebruikmaakt van de standaardwaarden. Het resulterende configuratiebestand gebruikt alleen de standaardwaarden omdat er geen andere parameters dan de parameter Path (waarmee het bestandspad wordt opgegeven) zijn opgenomen:

New-PSSessionConfigurationFile -Path .\Defaults.pssc

Gebruik de volgende opdracht om het nieuwe configuratiebestand weer te geven in de standaardteksteditor:

Invoke-Item -Path .\Defaults.pssc

Voor het maken van een sessieconfiguratie voor sessies waarin de gebruiker opdrachten kan uitvoeren, maar geen andere elementen van de PowerShell-taal gebruiken, typt u:

New-PSSessionConfigurationFile -LanguageMode NoLanguage
-Path .\NoLanguage.pssc

In de voorgaande opdracht kunt u de parameter LanguageMode instellen op NoLanguage om te voorkomen dat gebruikers bijvoorbeeld scripts schrijven of uitvoeren of variabelen gebruiken.

Voor het maken van een sessieconfiguratie voor sessies waarin gebruikers alleen cmdlets get kunnen gebruiken, typt u:

New-PSSessionConfigurationFile -VisibleCmdlets Get-*
-Path .\GetSessions.pssc

In het vorige voorbeeld beperkt het instellen van de parameter VisibleCmdlets op Get-* gebruikers tot cmdlets met namen die beginnen met de tekenreekswaarde 'Get-'.

Als u wilt maken van een sessieconfiguratie voor sessies die worden uitgevoerd onder een bevoegde virtuele account in plaats van de referenties van de gebruiker, typt u:

New-PSSessionConfigurationFile -RunAsVirtualAccount
-Path .\VirtualAccount.pssc

Voor het maken van een sessieconfiguratie voor sessies waarin de opdrachten die zichtbaar zijn voor de gebruiker zijn opgegeven in een bestand functiemogelijkheden, typt u:

New-PSSessionConfigurationFile -RoleDefinitions
@{ 'CONTOSO\User' = @{ RoleCapabilities = 'Maintenance' }}
-Path .\Maintenance.pssc

Een sessieconfiguratiebestand gebruiken

U kunt een sessieconfiguratiebestand opnemen wanneer u een sessieconfiguratie maakt of u kunt een bestand toevoegen aan de sessieconfiguratie op een later tijdstip.

Als u een sessieconfiguratiebestand wilt opnemen bij het maken van een sessieconfiguratie, gebruikt u de parameter Pad van de Register-PSSessionConfiguration cmdlet.

De volgende opdracht maakt bijvoorbeeld gebruik van het bestand NoLanguage.pssc wanneer een NoLanguage-sessieconfiguratie wordt gemaakt.

Register-PSSessionConfiguration -Name NoLanguage
-Path .\NoLanguage.pssc

Wanneer een nieuwe NoLanguage-sessie wordt gestart, hebben gebruikers alleen toegang tot PowerShell-opdrachten.

Als u een sessieconfiguratiebestand wilt toevoegen aan een bestaande sessieconfiguratie, gebruikt u de cmdlet Set-PSSessionConfiguration en de parameter Path. Dit is van invloed op nieuwe sessies die zijn gemaakt met de opgegeven sessieconfiguratie. Houd er rekening mee Set-PSSessionConfiguration-cmdlet de sessie zelf wijzigt en het sessieconfiguratiebestand niet wijzigt.

Met de volgende opdracht wordt bijvoorbeeld het bestand NoLanguage.pssc toegevoegd aan de sessieconfiguratie LockedDown.

Set-PSSessionConfiguration -Name LockedDown
-Path .\NoLanguage.pssc

Wanneer gebruikers de sessieconfiguratie LockedDown gebruiken om een sessie te maken, kunnen ze cmdlets uitvoeren, maar ze kunnen geen variabelen maken of gebruiken, waarden toewijzen of andere PowerShell-taalelementen gebruiken.

De volgende opdracht maakt gebruik van de New-PSSession cmdlet voor het maken van een sessie op de computer Srv01 die gebruikmaakt van de sessieconfiguratie LockedDown, een object verwijzing naar de sessie in de variabele $s opgeslagen. De ACL (toegangsbeheerlijst) van de sessieconfiguratie bepaalt wie deze kan gebruiken om een sessie te maken.

$s = New-PSSession -ComputerName Srv01
-ConfigurationName LockedDown

Omdat de NoLanguage-beperkingen zijn toegevoegd aan de configuratie van de LockedDown-sessie, kunnen gebruikers in LockedDown-sessies alleen PowerShell-opdrachten en -cmdlets uitvoeren. De volgende twee opdrachten gebruiken bijvoorbeeld de cmdlet Invoke-Command om opdrachten uit te voeren in de sessie waarnaar wordt verwezen in de $s variabele. De eerste opdracht, die de Get-UICulture cmdlet en geen variabelen gebruikt, slaagt. De tweede opdracht, waarmee de waarde van de variabele $PSUICulture, mislukt.

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

Een sessieconfiguratiebestand bewerken

Alle instellingen in een sessieconfiguratie, met uitzondering van RunAsVirtualAccount en RunAsVirtualAccountGroups, kunnen worden gewijzigd door het sessieconfiguratiebestand te bewerken dat wordt gebruikt door de sessieconfiguratie. Als u dit wilt doen, begint u met het zoeken naar de actieve kopie van het sessieconfiguratiebestand.

Wanneer u een sessieconfiguratiebestand gebruikt in een sessieconfiguratie, maakt PowerShell een actieve kopie van het sessieconfiguratiebestand en slaat het bestand op in $de map pshomeSessionConfig\ op de lokale computer.

De locatie van de actieve kopie van een sessieconfiguratiebestand wordt opgeslagen in de eigenschap ConfigFilePath van het sessieconfiguratieobject.

Met de volgende opdracht wordt de locatie van het sessieconfiguratiebestand voor de NoLanguage-sessieconfiguratie opgeslagen.

(Get-PSSessionConfiguration -Name NoLanguage).ConfigFilePath

Deze opdracht retourneert een bestandspad dat lijkt op het volgende:

C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\
NoLanguage_0c115179-ff2a-4f66-a5eb-e56e5692ba22.pssc

U kunt het .pssc-bestand bewerken in elke teksteditor. Nadat het bestand is opgeslagen, wordt het gebruikt door nieuwe sessies die gebruikmaken van de sessieconfiguratie.

Als u de instellingen RunAsVirtualAccount of RunAsVirtualAccountGroups moet wijzigen, moet u de registratie van de sessieconfiguratie opheffen en een sessieconfiguratiebestand met de bewerkte waarden opnieuw registreren.

Een sessieconfiguratiebestand testen

Gebruik de Test-PSSessionConfigurationFile om handmatig bewerkte sessieconfiguratiebestanden te testen. Dat is belangrijk: als de bestandssyntaxis en waarden ongeldig zijn, kunnen gebruikers de sessieconfiguratie niet gebruiken om een sessie te maken.

Met de volgende opdracht wordt bijvoorbeeld het configuratiebestand voor de actieve sessie van de NoLanguage-sessieconfiguratie getest.

Test-PSSessionConfigurationFile -Path C:\WINDOWS\System32\
WindowsPowerShell\v1.0\SessionConfig\
NoLanguage_0c115179-ff2a-4f66-a5eb-e56e5692ba22.pssc

Als de syntaxis en waarden in het configuratiebestand geldig zijn, Test-PSSessionConfigurationFile true als. Als de syntaxis en waarden ongeldig zijn, retourneert de cmdlet False.

U kunt de Test-PSSessionConfigurationFile om een sessieconfiguratiebestand te testen, met inbegrip van bestanden die de New-PSSessionConfiguration cmdlet maakt. Zie het Help-onderwerp voor de Test-PSSessionConfigurationFile cmdlet voor meer informatie.

Een sessieconfiguratiebestand verwijderen

U kunt een sessieconfiguratiebestand niet verwijderen uit een sessieconfiguratie. U kunt het bestand echter vervangen door een nieuw bestand dat gebruikmaakt van de standaardinstellingen. Hiermee annuleert u de instellingen die worden gebruikt door het oorspronkelijke configuratiebestand.

Als u een sessieconfiguratiebestand wilt vervangen, maakt u een nieuw sessieconfiguratiebestand dat gebruikmaakt van de standaardinstellingen en gebruikt u vervolgens de cmdlet Set-PSSessionConfiguration om het aangepaste sessieconfiguratiebestand te vervangen door het nieuwe bestand.

Met de volgende opdrachten maakt u bijvoorbeeld een standaardsessieconfiguratiebestand en vervangt u vervolgens het actieve sessieconfiguratiebestand in de noLanguage-sessieconfiguratie.

New-PSSessionConfigurationFile -Path .\Default.pssc
Set-PSSessionConfiguration -Name NoLanguage
-Path .\Default.pssc

Wanneer deze opdrachten zijn voltooien, biedt de configuratie van de NoLanguage-sessie in feite volledige taalondersteuning (de standaardinstelling) voor alle sessies die zijn gemaakt met die sessieconfiguratie.

De eigenschappen van een sessieconfiguratie weergeven De sessieconfiguratieobjecten die sessieconfiguraties vertegenwoordigen die sessieconfiguratiebestanden gebruiken, hebben aanvullende eigenschappen die het gemakkelijk maken om de sessieconfiguratie te detecteren en te analyseren. (De typenaam die hieronder wordt weergegeven, bevat een opgemaakte weergavedefinitie.) U kunt de eigenschappen weergeven door de cmdlet Get-PSSessionConfiguration en de geretourneerde gegevens door te spitten naar de Get-Member cmdlet:

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...

Met deze eigenschappen kunt u eenvoudig zoeken naar specifieke sessieconfiguraties. U kunt bijvoorbeeld de eigenschap ExecutionPolicy gebruiken om een sessieconfiguratie te vinden die ondersteuning biedt voor sessies met het uitvoeringsbeleid RemoteSigned. Omdat de eigenschap ExecutionPolicy alleen bestaat op sessies die gebruikmaken van sessieconfiguratiebestanden, retourneert de opdracht mogelijk niet alle in aanmerking komende sessieconfiguraties.

Get-PSSessionConfiguration |
where {$_.ExecutionPolicy -eq "RemoteSigned"}

Met de volgende opdracht worden sessieconfiguraties op basis waarvan RunAsUser de Exchange is.

 Get-PSSessionConfiguration |
where {$_.RunAsUser -eq "Exchange01\Admin01"}

Als u informatie wilt weergeven over de roldefinities die zijn gekoppeld aan een configuratie, gebruikt Get-PSSessionCapability cmdlet . Met deze cmdlet kunt u bepalen welke opdrachten en omgeving beschikbaar zijn voor specifieke gebruikers in specifieke eindpunten.

Notities

Sessieconfiguraties ondersteunen ook een type sessie dat een 'lege' sessie wordt genoemd. Met een leeg sessietype kunt u aangepaste sessies maken met geselecteerde opdrachten. Als u geen modules, functies of scripts toevoegt aan een lege sessie, is de sessie beperkt tot expressies en is deze mogelijk niet praktisch van pas. De eigenschap SessionType geeft aan of u met een lege sessie werkt of niet.

Zie ook