Delen via

Set-PSSessionConfiguration

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee wijzigt u de eigenschappen van een geregistreerde sessieconfiguratie.

Syntaxis

Set-PSSessionConfiguration
   [-Name] <String>
   [-ApplicationBase <String>]
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-PSVersion <Version>]
   [-SessionTypeOption <PSSessionTypeOption>]
   [-TransportOption <PSTransportOption>]
   [-ModulesToImport <Object[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-PSSessionConfiguration
   [-Name] <String>
   [-AssemblyName] <String>
   [-ApplicationBase <String>]
   [-ConfigurationTypeName] <String>
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-PSVersion <Version>]
   [-SessionTypeOption <PSSessionTypeOption>]
   [-TransportOption <PSTransportOption>]
   [-ModulesToImport <Object[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-PSSessionConfiguration
   [-Name] <String>
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-TransportOption <PSTransportOption>]
   -Path <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Deze cmdlet is alleen beschikbaar op het Windows-platform.

De Set-PSSessionConfiguration cmdlet wijzigt de eigenschappen van de sessieconfiguraties op de lokale computer.

Gebruik de parameter Naam om de sessieconfiguratie te identificeren die u wilt wijzigen. Gebruik de andere parameters om nieuwe waarden op te geven voor de eigenschappen van de sessieconfiguratie. Als u een eigenschapswaarde uit de configuratie wilt verwijderen en de standaardwaarde wilt gebruiken, voert u een lege tekenreeks ("") of een waarde van $Null voor de bijbehorende parameter in.

Vanaf PowerShell 3.0 kunt u een sessieconfiguratiebestand gebruiken om een sessieconfiguratie te definiëren. Deze functie biedt een eenvoudige en detecteerbare methode voor het instellen en wijzigen van de eigenschappen van sessies die gebruikmaken van de sessieconfiguratie. Als u een sessieconfiguratiebestand wilt opgeven, gebruikt u de padparameter van Set-PSSessionConfiguration. Zie about_Session_Configuration_Files voor meer informatie over sessieconfiguratiebestanden. Zie de New-PSSessionConfigurationFile cmdlet voor informatie over het maken en wijzigen van een sessieconfiguratiebestand.

Sessieconfiguraties definiëren de omgeving van externe sessies (PSSessions) die verbinding maken met de lokale computer. Elke PSSession maakt gebruik van een sessieconfiguratie. De sessieconfiguratie bepaalt de functies van de PSSession, zoals de modules die beschikbaar zijn in de sessie, de cmdlets die mogen worden uitgevoerd, de taalmodus, quota en time-outs. De beveiligingsdescriptor van de sessieconfiguratie bepaalt wie de sessieconfiguratie kan gebruiken om verbinding te maken met de lokale computer. Zie about_Session_Configurations (Engelstalig) voor meer informatie over sessieconfiguraties.

Als u de eigenschappen van een sessieconfiguratie wilt bekijken, gebruikt u de Get-PSSessionConfiguration cmdlet of de WSMan-provider. Typ voor meer informatie over de WSMan-provider Get-Help WSMan.

Voorbeelden

Voorbeeld 1: Een sessieconfiguratie maken en wijzigen

In dit voorbeeld ziet u hoe u een opstartscript toevoegt aan en verwijdert uit een configuratie.

Met de eerste opdracht maakt u de AdminShell-configuratie . Met de tweede opdracht wordt het AdminConfig.ps1 script toegevoegd aan de configuratie. De wijziging is van kracht wanneer u WinRM opnieuw start. Met de derde opdracht wordt het AdminConfig.ps1 script uit de configuratie verwijderd.

Register-PSSessionConfiguration -Name "AdminShell" -AssemblyName "C:\Shells\AdminShell.dll" -ConfigurationTypeName "AdminClass"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript "AdminConfig.ps1"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript $Null

Voorbeeld 2: Resultaten weergeven

In dit voorbeeld wordt de waarde van de eigenschap MaximumReceivedObjectSizeMB verhoogd naar 20. Met deze opdracht wordt u ook gevraagd om de WinRM-service opnieuw op te starten. De wijziging is pas van kracht nadat de WinRM-service opnieuw is gestart.

Set-PSSessionConfiguration -Name "IncObj" -MaximumReceivedObjectSizeMB 20

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\IncObj\InitializationParameters

ParamName                       ParamValue
---------                       ----------
psmaximumreceivedobjectsizemb   20

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Voorbeeld 3: Resultaten op verschillende manieren weergeven

In dit voorbeeld Set-PSSessionConfiguration wijzigt u het opstartscript in de configuratie van de MaintenanceShell-sessie in Maintenance.ps1. In de uitvoer ziet u de wijziging en wordt u gevraagd om de WinRM-service opnieuw te starten. Het antwoord is y (ja).

Get-PSSessionConfiguration haalt de MaintenanceShell-sessieconfiguratie op. De pijplijnoperator (|) verzendt de resultaten van de opdracht naar Format-List, waarin alle eigenschappen van het configuratieobject in een lijst worden weergegeven. Vervolgens bekijken we met behulp van de WSMan-provider de initialisatieparameters voor de MaintenanceShell-configuratie . Get-ChildItem haalt de onderliggende items op in het knooppunt InitializationParameters voor de MaintenanceShell-invoegtoepassing . Typ voor meer informatie over de WSMan-provider Get-Help wsman.

Set-PSSessionConfiguration -Name "MaintenanceShell" -StartupScript "C:\ps-test\Maintenance.ps1"

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName            ParamValue
---------            ----------
startupscript        c:\ps-test\Mainte...

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run
the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Get-PSSessionConfiguration MaintenanceShell | Format-List -Property *

xmlns            : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Name             : MaintenanceShell
Filename         : %windir%\system32\pwrshplugin.dll
SDKVersion       : 1
XmlRenderingType : text
lang             : en-US
PSVersion        : 2.0
startupscript    : c:\ps-test\Maintenance.ps1
ResourceUri      : http://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch       : true
Capability       : {Shell}
Permission       :

Get-ChildItem WSMan:\localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName     ParamValue
---------     ----------
PSVersion     2.0
startupscript c:\ps-test\Maintenance.ps1

Parameters

-AccessMode

Hiermee wordt de sessieconfiguratie ingeschakeld en uitgeschakeld en wordt bepaald of deze kan worden gebruikt voor externe of lokale sessies op de computer. De aanvaardbare waarden voor deze parameter zijn:

  • Disabled. Hiermee schakelt u de sessieconfiguratie uit. Het kan niet worden gebruikt voor externe of lokale toegang tot de computer. Met deze waarde wordt de eigenschap Ingeschakeld van de sessieconfiguratie (WSMan:\<ComputerName>\PlugIn\<SessionConfigurationName>\Enabled) ingesteld op False.
  • Local. Voegt een Network_Deny_All vermelding toe aan de beveiligingsdescriptor van de sessieconfiguratie. Gebruikers van de lokale computer kunnen de sessieconfiguratie gebruiken om een lokale loopbacksessie op dezelfde computer te maken, maar externe gebruikers krijgen geen toegang.
  • Remote. Verwijdert Deny_All en Network_Deny_All vermeldingen uit de beveiligingsdescriptors van de sessieconfiguratie. Gebruikers van lokale en externe computers kunnen de sessieconfiguratie gebruiken om sessies te maken en opdrachten uit te voeren op deze computer.

De standaardwaarde is Remote.

Andere cmdlets kunnen de waarde van deze parameter later overschrijven. Met de Enable-PSRemoting cmdlet kunt u bijvoorbeeld alle sessieconfiguraties op de computer inschakelen en externe toegang tot deze configuraties toestaan. De Disable-PSRemoting cmdlet staat alleen lokale toegang toe tot alle sessieconfiguraties op de computer.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:PSSessionConfigurationAccessMode
Geaccepteerde waarden:Disabled, Local, Remote
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ApplicationBase

Hiermee geeft u het pad op van het assemblybestand (*.dll) dat is opgegeven in de waarde van de parameter AssemblyName .

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AssemblyName

Hiermee geeft u de assemblynaam. Met deze cmdlet maakt u een sessieconfiguratie op basis van een klasse die is gedefinieerd in een assembly.

Voer de bestandsnaam of het volledige pad in van een assemblybestand .dll dat een sessieconfiguratie definieert. Als u alleen de bestandsnaam invoert, kunt u het pad invoeren in de waarde van de parameter ApplicationBase .

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConfigurationTypeName

Hiermee geeft u het type van de sessieconfiguratie die is gedefinieerd in de assembly in de parameter AssemblyName . Het type dat u opgeeft, moet de klasse System.Management.Automation.Remoting.PSSessionConfiguration implementeren.

Deze parameter is vereist wanneer u een assemblynaam opgeeft.

Type:String
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Onderdrukt alle gebruikersprompts en start de WinRM-service opnieuw zonder te vragen. Als u de service opnieuw start, wordt de configuratiewijziging effectief.

Gebruik de parameter NoServiceRestart om opnieuw opstarten te voorkomen en de prompt voor opnieuw opstarten te onderdrukken.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaximumReceivedDataSizePerCommandMB

Hiermee geeft u de limiet op voor de hoeveelheid gegevens die in één externe opdracht naar deze computer kan worden verzonden. Voer de gegevensgrootte in megabytes (MB) in. De standaardwaarde is 50.

Als een gegevensgroottelimiet is gedefinieerd in het configuratietype dat is opgegeven in de parameter ConfigurationTypeName , wordt de limiet in het configuratietype gebruikt. De waarde van deze parameter wordt genegeerd.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaximumReceivedObjectSizeMB

Hiermee geeft u de limieten op voor de hoeveelheid gegevens die in één object naar deze computer kan worden verzonden. Voer de gegevensgrootte in megabytes in. De standaardwaarde is 10.

Als een objectgroottelimiet is gedefinieerd in het configuratietype dat is opgegeven in de parameter ConfigurationTypeName , wordt de limiet in het configuratietype gebruikt. De waarde van deze parameter wordt genegeerd.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ModulesToImport

Hiermee geeft u de modules en modules op die automatisch worden geïmporteerd in sessies die gebruikmaken van de sessieconfiguratie. Voer de module- en modulenamen in.

Standaard wordt alleen de Module Microsoft.PowerShell.Core geïmporteerd in sessies, maar tenzij de cmdlets zijn uitgesloten, kunt u de Import-Module modules en Add-PSSnapin modules en modules toevoegen aan de sessie, tenzij de cmdlets zijn uitgesloten.

De modules die zijn opgegeven in deze parameterwaarde, worden geïmporteerd naast modules die zijn opgegeven in het sessieconfiguratiebestand (New-PSSessionConfigurationFile). Instellingen in het sessieconfiguratiebestand kunnen echter de opdrachten verbergen die door modules worden geëxporteerd of voorkomen dat gebruikers ze gebruiken.

De modules die in deze parameterwaarde zijn opgegeven, vervangen de lijst met modules die zijn opgegeven door de parameter ModulesToImport van de Register-PSSessionConfiguration cmdlet.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:Object[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van de sessieconfiguratie die u wilt wijzigen.

U kunt deze parameter niet gebruiken om de naam van de sessieconfiguratie te wijzigen.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NoServiceRestart

Start de WinRM-service niet opnieuw op en onderdrukt de prompt om de service opnieuw op te starten.

Wanneer u uitvoert Set-PSSessionConfiguration, wordt u standaard gevraagd om de WinRM-service opnieuw te starten om de nieuwe sessieconfiguratie effectief te maken. Totdat de WinRM-service opnieuw is opgestart, is de nieuwe sessieconfiguratie niet effectief.

Als u de WinRM-service opnieuw wilt starten zonder te vragen, gebruikt u de parameter Force . Als u de WinRM-service handmatig opnieuw wilt starten, gebruikt u de Restart-Service cmdlet.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Hiermee geeft u het pad van een sessieconfiguratiebestand (.pssc), zoals een bestand dat is gemaakt door de New-PSSessionConfigurationFile cmdlet. Als u het pad weglaat, is de standaardwaarde de huidige map.

Zie het Help-onderwerp voor de New-PSSessionConfigurationFile cmdlet voor informatie over het wijzigen van een sessieconfiguratiebestand.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PSVersion

Hiermee geeft u de versie van PowerShell op in sessies die gebruikmaken van deze sessieconfiguratie.

De waarde van deze parameter heeft voorrang op de waarde van de PowerShellVersion-sleutel in het sessieconfiguratiebestand.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:Version
Aliassen:PowerShellVersion
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsCredential

Hiermee geeft u referenties voor opdrachten in de sessie. Opdrachten worden standaard uitgevoerd met de machtigingen van de huidige gebruiker.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SecurityDescriptorSddl

Hiermee geeft u een andere SDDL-tekenreeks (Security Descriptor Definition Language) op voor de configuratie.

Deze tekenreeks bepaalt de machtigingen die vereist zijn voor het gebruik van de nieuwe sessieconfiguratie. Als u een sessieconfiguratie in een sessie wilt gebruiken, moeten gebruikers ten minste Execute(Invoke) machtigingen hebben voor de configuratie.

Als u de standaardbeveiligingsdescriptor voor de configuratie wilt gebruiken, voert u een lege tekenreeks ("") of een waarde van $Null. De standaardwaarde is de SDDL-hoofdmap in het WSMan: station.

Als de beveiligingsdescriptor complex is, kunt u overwegen om de parameter ShowSecurityDescriptorUI te gebruiken in plaats van deze. U kunt beide parameters niet gebruiken in dezelfde opdracht.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SessionTypeOption

Hiermee geeft u typespecifieke opties voor de sessieconfiguratie. Voer een sessietypeoptiesobject in, zoals het PSWorkflowExecutionOption-object dat door de New-PSWorkflowExecutionOption cmdlet wordt geretourneerd.

De opties van sessies die gebruikmaken van de sessieconfiguratie worden bepaald door de waarden van sessieopties en de opties voor sessieconfiguratie. Tenzij opgegeven, hebben opties die zijn ingesteld in de sessie, zoals met de New-PSSessionOption cmdlet, voorrang op opties die zijn ingesteld in de sessieconfiguratie. Waarden voor sessieopties mogen echter niet groter zijn dan de maximumwaarden die zijn ingesteld in de sessieconfiguratie.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:PSSessionTypeOption
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ShowSecurityDescriptorUI

Wanneer deze parameter wordt gebruikt, opent de cmdlet een eigenschappenvenster waarmee u een nieuwe SDDL voor de sessieconfiguratie kunt maken. Het eigenschappenvenster wordt weergegeven nadat u de Set-PSSessionConfiguration opdracht hebt uitgevoerd en start vervolgens de WinRM-service opnieuw op.

Wanneer u machtigingen instelt voor de configuratie, moet u er rekening mee houden dat gebruikers ten minste Execute(Invoke) machtigingen moeten hebben om de sessieconfiguratie in een sessie te kunnen gebruiken.

U kunt de parameter SecurityDescriptorSDDL en deze parameter niet gebruiken in dezelfde opdracht.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-StartupScript

Hiermee geeft u het opstartscript voor de configuratie. Voer het volledig gekwalificeerde pad van een PowerShell-script in. Het opgegeven script wordt uitgevoerd in de nieuwe sessie die gebruikmaakt van de sessieconfiguratie.

Als u een opstartscript uit een sessieconfiguratie wilt verwijderen, voert u een lege tekenreeks ("") of een waarde van $Null.

U kunt een opstartscript gebruiken om de gebruikerssessie verder te configureren. Als het script een fout genereert, zelfs een niet-afsluitfout, wordt de sessie niet gemaakt en mislukt de New-PSSession opdracht.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ThreadApartmentState

Hiermee geeft u de appartementsstatus van de threadingmodule die moet worden gebruikt. Acceptabele waarden zijn:

  • Unknown
  • MTA
  • STA
Type:ApartmentState
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ThreadOptions

Hiermee geeft u de instelling voor threadopties in de configuratie. Met deze instelling wordt gedefinieerd hoe threads worden gemaakt en gebruikt wanneer een opdracht wordt uitgevoerd in de sessie. De aanvaardbare waarden voor deze parameter zijn:

  • Default
  • ReuseThread
  • UseCurrentThread
  • UseNewThread

De standaardwaarde is UseCurrentThread.

Zie de opsomming PSThreadOptions voor meer informatie.

Type:PSThreadOptions
Geaccepteerde waarden:Default, UseNewThread, ReuseThread, UseCurrentThread
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TransportOption

Hiermee geeft u de transportopties voor de sessieconfiguratie. Voer een transportoptiesobject in, zoals het WSManConfigurationOption-object dat door de New-PSTransportOption cmdlet wordt geretourneerd.

De opties van sessies die gebruikmaken van de sessieconfiguratie worden bepaald door de waarden van sessieopties en de opties voor sessieconfiguratie. Tenzij opgegeven, hebben opties die zijn ingesteld in de sessie, zoals met de New-PSSessionOption cmdlet, voorrang op opties die zijn ingesteld in de sessieconfiguratie. Waarden voor sessieopties mogen echter niet groter zijn dan de maximumwaarden die zijn ingesteld in de sessieconfiguratie.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:PSTransportOption
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UseSharedProcess

Gebruik slechts één proces om alle sessies te hosten die door dezelfde gebruiker zijn gestart en dezelfde sessieconfiguratie te gebruiken. Standaard wordt elke sessie gehost in een eigen proces.

Deze parameter is geïntroduceerd in PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

WSManConfigLeafElement

Notities

Deze cmdlet is alleen beschikbaar op Windows-platforms.

Als u deze cmdlet wilt uitvoeren, start u PowerShell met behulp van de optie Als administrator uitvoeren.

De Set-PSSessionConfiguration cmdlet wijzigt de configuratienaam niet en de WSMan-provider biedt geen ondersteuning voor de Rename-Item cmdlet. Als u de naam van een sessieconfiguratie wilt wijzigen, gebruikt u de Unregister-PSSessionConfiguration cmdlet om de configuratie te verwijderen en gebruikt u vervolgens de Register-PSSessionConfiguration cmdlet om een nieuwe sessieconfiguratie te maken en te registreren.

U kunt de Set-PSSessionConfiguration cmdlet gebruiken om de standaard Microsoft.PowerShell - en Microsoft.PowerShell32 sessieconfiguraties te wijzigen. Ze zijn niet beschermd. Als u wilt terugkeren naar de oorspronkelijke versie van een standaardsessieconfiguratie, gebruikt u de Unregister-PSSessionConfiguration cmdlet om de standaardsessieconfiguratie te verwijderen en gebruikt u vervolgens de Enable-PSRemoting cmdlet om deze te herstellen.

De eigenschappen van een sessieconfiguratieobject variëren met de opties die zijn ingesteld voor de sessieconfiguratie en de waarden van deze opties. Daarnaast hebben sessieconfiguraties die gebruikmaken van een sessieconfiguratiebestand aanvullende eigenschappen.

U kunt opdrachten in het WSMan: station gebruiken om de eigenschappen van sessieconfiguraties te wijzigen. U kunt het WSMan: station in PowerShell 2.0 echter niet gebruiken om de eigenschappen van de sessieconfiguratie te wijzigen die zijn geïntroduceerd in PowerShell 3.0, zoals OutputBufferingMode. Windows PowerShell 2.0-opdrachten genereren geen fout, maar ze zijn ineffectief. Als u eigenschappen wilt wijzigen die zijn geïntroduceerd in PowerShell 3.0, gebruikt u het WSMan: station in PowerShell 3.0 of hoger.