Windows PowerShell-sessiestatus

Sessiestatus verwijst naar de huidige configuratie van een Windows PowerShell-sessie of -module. Een Windows PowerShell-sessie is de operationele omgeving die interactief wordt gebruikt door de opdrachtregelgebruiker of programmatisch door een hosttoepassing. De sessiestatus voor een sessie wordt de globale sessiestatus genoemd.

Vanuit het oogpunt van ontwikkelaars verwijst een Windows PowerShell-sessie naar de tijd tussen wanneer een hosttoepassing een Windows PowerShell-runspace opent en wanneer deze de runspace sluit. Er is een andere manier bekeken, de sessie is de levensduur van een exemplaar van de Windows PowerShell-engine die wordt aangeroepen terwijl de runspace bestaat.

Sessiestatus van module

Modulesessiestatussen worden gemaakt wanneer de module of een van de geneste modules wordt geïmporteerd in de sessie. Wanneer een module een element exporteert, zoals een cmdlet, functie of script, wordt er een verwijzing naar dat element toegevoegd aan de globale sessiestatus van de sessie. Wanneer het element echter wordt uitgevoerd, wordt het uitgevoerd binnen de sessiestatus van de module.

Session-State gegevens

Sessiestatusgegevens kunnen openbaar of privé zijn. Openbare gegevens zijn beschikbaar voor aanroepen van buiten de sessiestatus, terwijl privégegevens alleen beschikbaar zijn voor oproepen vanuit de sessiestatus. Een module kan bijvoorbeeld een privéfunctie hebben die alleen kan worden aangeroepen door de module of alleen intern door een openbaar element dat is geëxporteerd. Dit is vergelijkbaar met de privé- en openbare leden van een .NET Framework-type.

Sessiestatusgegevens worden opgeslagen door het huidige exemplaar van de uitvoeringsengine binnen de context van de huidige Windows PowerShell-sessie. Sessiestatusgegevens bestaan uit de volgende items:

• Padgegevens

• Stationsinformatie

• Windows PowerShell-providergegevens

• Informatie over de geïmporteerde modules en verwijzingen naar de module-elementen (zoals cmdlets, functies en scripts) die door de module worden geëxporteerd. Deze informatie en deze verwijzingen zijn alleen voor de globale sessiestatus.

• Informatie over sessiestatusvariabelen

Toegang tot Session-State gegevens binnen cmdlets

Cmdlets hebben indirect toegang tot sessiestatusgegevens via de eigenschap System.Management.Automation.PSCmdlet.SessionState* van de cmdlet-klasse of rechtstreeks via de klasse System.Management.Automation.SessionState. De klasse System.Management.Automation.SessionState biedt eigenschappen die kunnen worden gebruikt om verschillende typen sessiestatusgegevens te onderzoeken.

Zie ook

System.Management.Automation.PSCmdlet.SessionState

System.Management.Automation.SessionState

Windows PowerShell-cmdlets

Een Windows PowerShell-cmdlet schrijven

Windows PowerShell Shell SDK