Set-PSSessionConfiguration
Hiermee wijzigt u de eigenschappen van een geregistreerde sessieconfiguratie.
Syntax
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 Name 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
in voor de bijbehorende parameter.
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 path-parameter van Set-PSSessionConfiguration
. Zie about_Session_Configuration_Files voor 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 zien, 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 Creatie 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 wordt doorgevoerd 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 de WinRM-service opnieuw te starten. De wijziging wordt pas doorgevoerd als 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
wordt het opstartscript in de configuratie van de MaintenanceShell-sessie gewijzigd in Maintenance.ps1
. In de uitvoer ziet u de wijziging en wordt u gevraagd 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
, waarmee 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 schakelt u de sessieconfiguratie in en uit en bepaalt u 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 opFalse
.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 wordt de toegang geweigerd.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 Extern.
Andere cmdlets kunnen de waarde van deze parameter later overschrijven. De cmdlet schakelt bijvoorbeeld Enable-PSRemoting
alle sessieconfiguraties op de computer in en staat externe toegang tot deze configuraties toe, en 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 |
Accepted values: | Disabled, Local, Remote |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AssemblyName
Hiermee geeft u de naam van de assembly. 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 |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigurationTypeName
Hiermee geeft u het type sessieconfiguratie op dat 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 |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Onderdrukt alle gebruikersprompts en start de WinRM-service opnieuw zonder te vragen. Als u de service opnieuw start, wordt de configuratiewijziging van kracht.
Gebruik de parameter NoServiceRestart om opnieuw opstarten te voorkomen en de prompt voor opnieuw opstarten te onderdrukken.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumReceivedDataSizePerCommandMB
Hiermee geeft u de limiet voor de hoeveelheid gegevens die naar deze computer kan worden verzonden in een enkele externe opdracht. Voer de gegevensgrootte in megabytes (MB) in. De standaardwaarde is 50
.
Als er een limiet voor de gegevensgrootte 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumReceivedObjectSizeMB
Hiermee geeft u de limieten voor de hoeveelheid gegevens die naar deze computer kan worden verzonden in een enkel object.
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 worden uitgesloten, kunt u de Import-Module
cmdlets en Add-PSSnapin
gebruiken om modules en modules aan de sessie toe te voegen.
De modules die in deze parameterwaarde zijn opgegeven, worden geïmporteerd als aanvulling op 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 deze 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NoServiceRestart
Start de WinRM-service niet opnieuw en onderdrukt de prompt om de service opnieuw te starten.
Wanneer u uitvoert Set-PSSessionConfiguration
, wordt u standaard gevraagd de WinRM-service opnieuw te starten om de nieuwe sessieconfiguratie van kracht te maken. Totdat de WinRM-service opnieuw wordt gestart, is de nieuwe sessieconfiguratie niet van kracht.
Als u de WinRM-service opnieuw wilt starten zonder te vragen, gebruikt u de parameter Force . Gebruik Restart-Service
de cmdlet om de WinRM-service handmatig opnieuw te starten.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Hiermee geeft u het pad van een sessieconfiguratiebestand (.pssc
), zoals een gemaakt door de New-PSSessionConfigurationFile
cmdlet. Als u het pad weglaat, is de standaardwaarde de huidige map.
Zie het Help-onderwerp voor de cmdlet voor informatie over het wijzigen van een New-PSSessionConfigurationFile
sessieconfiguratiebestand.
Deze parameter is geïntroduceerd in PowerShell 3.0.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Aliases: | PowerShellVersion |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecurityDescriptorSddl
Hiermee geeft u een andere SDDL-tekenreeks (Security Descriptor Definition Language) 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)
over machtigingen voor de configuratie beschikken.
Als u de standaardbeveiligingsdescriptor voor de configuratie wilt gebruiken, voert u een lege tekenreeks (""
) of een waarde in van $Null
. De standaardwaarde is de SDDL-hoofdmap in het WSMan:
station.
Als de security descriptor complex is, kunt u de parameter ShowSecurityDescriptorUI gebruiken in plaats van deze parameter. U kunt niet beide parameters in dezelfde opdracht gebruiken.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 sessieconfiguratieopties. 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. Sessieoptiewaarden 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 de WinRM-service opnieuw hebt gestart.
Wanneer u machtigingen voor de configuratie instelt, moet u er rekening mee houden dat gebruikers ten minste Execute(Invoke)
machtigingen moeten hebben om de sessieconfiguratie in een sessie te gebruiken.
U kunt de parameter SecurityDescriptorSDDL en deze parameter niet in dezelfde opdracht gebruiken.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 wilt verwijderen uit een sessieconfiguratie, voert u een lege tekenreeks (""
) of een waarde in 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThreadApartmentState
Hiermee geeft u de appartementstatus van de threading-module die moet worden gebruikt. Acceptabele waarden zijn:
Unknown
MTA
STA
Type: | ApartmentState |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ThreadOptions
Hiermee geeft u de instelling voor threadopties in de configuratie op. Deze instelling bepaalt 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 PSThreadOptions Enumeration (PsThreadOptions Enumeration) voor meer informatie.
Type: | PSThreadOptions |
Accepted values: | Default, UseNewThread, ReuseThread, UseCurrentThread |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 sessieconfiguratieopties. 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. Sessieoptiewaarden 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSharedProcess
Gebruik slechts één proces om alle sessies te hosten die zijn gestart door dezelfde gebruiker en dezelfde sessieconfiguratie te gebruiken. Standaard wordt elke sessie in een eigen proces gehost.
Deze parameter is geïntroduceerd in PowerShell 3.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
None
U kunt geen objecten doorspezen naar deze cmdlet.
Uitvoerwaarden
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 afhankelijk van de opties die zijn ingesteld voor de sessieconfiguratie en de waarden van deze opties. Sessieconfiguraties die gebruikmaken van een sessieconfiguratiebestand hebben ook 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 niet effectief. Als u eigenschappen wilt wijzigen die zijn geïntroduceerd in PowerShell 3.0, gebruikt u het WSMan:
station in PowerShell 3.0 of hoger.
Verwante koppelingen
- Disable-PSSessionConfiguration
- Enable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- New-PSTransportOption
- Register-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan Provider
- about_Session_Configurations
- about_Session_Configuration_Files