Contact Info

Crumbtrail » Administration » Powershell » Powershell 3.0 » Set-PSSessionConfiguration

Set-PSSessionConfiguration - Powershell 3.0 CmdLet

ActiveXperts Network Monitor ships with integrated Powershell scripts to monitor complex network. The scripts run out of the box
Download the ActiveXperts Network Monitor FREE version now »


Short description
Changes the properties of a registered session configuration.

Set-PSSessionConfiguration [-Name] <String> [-AccessMode <PSSessionConfigurationAccessMode>] [-ApplicationBase <String>
] [-Force] [-MaximumReceivedDataSizePerCommandMB <Double>] [-MaximumReceivedObjectSizeMB <Double>] [-ModulesToImport <S
tring[]>] [-NoServiceRestart] [-PSVersion <Version>] [-RunAsCredential <PSCredential>] [-SecurityDescriptorSddl <String
>] [-SessionTypeOption <PSSessionTypeOption>] [-ShowSecurityDescriptorUI] [-StartupScript <String>] [-ThreadApartmentSt
ate <ApartmentState>] [-ThreadOptions <PSThreadOptions>] [-TransportOption <PSTransportOption>] [-UseSharedProcess] [-C
onfirm] [-WhatIf] [<CommonParameters>]
Set-PSSessionConfiguration [-Name] <String> [-AssemblyName] <String> [-ConfigurationTypeName] <String> [-AccessMode <PS
SessionConfigurationAccessMode>] [-ApplicationBase <String>] [-Force] [-MaximumReceivedDataSizePerCommandMB <Double>] [
-MaximumReceivedObjectSizeMB <Double>] [-ModulesToImport <String[]>] [-NoServiceRestart] [-PSVersion <Version>] [-RunAs
Credential <PSCredential>] [-SecurityDescriptorSddl <String>] [-SessionTypeOption <PSSessionTypeOption>] [-ShowSecurity
DescriptorUI] [-StartupScript <String>] [-ThreadApartmentState <ApartmentState>] [-ThreadOptions <PSThreadOptions>] [-T
ransportOption <PSTransportOption>] [-UseSharedProcess] [-Confirm] [-WhatIf] [<CommonParameters>]
Set-PSSessionConfiguration [-Name] <String> [-AccessMode <PSSessionConfigurationAccessMode>] [-Force] [-MaximumReceived
DataSizePerCommandMB <Double>] [-MaximumReceivedObjectSizeMB <Double>] [-NoServiceRestart] [-RunAsCredential <PSCredent
ial>] [-SecurityDescriptorSddl <String>] [-ShowSecurityDescriptorUI] [-StartupScript <String>] [-ThreadApartmentState <
ApartmentState>] [-ThreadOptions <PSThreadOptions>] [-TransportOption <PSTransportOption>] [-UseSharedProcess] -Path <S
tring> [-Confirm] [-WhatIf] [<CommonParameters>]

The Set-PSSessionConfiguration cmdlet changes the properties of the session configurations on the local computer.

Use the Name parameter to identify the session configuration that you want to change. Use the other parameters to speci
fy new values for the properties of the session configuration. To delete a property value from the configuration (and u
se the default value), enter an empty string ("") or a value of $null for the corresponding parameter.

Beginning in Windows PowerShell 3.0, you can use a session configuration file to define a session configuration. This f
eature provides a simple and discoverable method for setting and changing the properties of sessions that use the sessi
on configuration. To specify a session configuration file, use the Path parameter of Set-PSSessionConfiguration. For in
formation about session configuration files, see about_Session_Configuration_Files (
kID=236023). For information about creating and editing a session configuration file, see New-PSSessionConfigurationFil

Session configurations define the environment of remote sessions (PSSessions) that connect to the local computer. Every
 PSSession uses a session configuration. The session configuration determines the features of the PSSession, such as th
e modules that are available in the session, the cmdlets that are permitted to run, the language mode, quotas, and time
outs. The security descriptor (SDDL) of the session configuration determines who can use the session configuration to c
onnect to the local computer. For more information about session configurations, see about_Session_Configurations.

To see the properties of a session configuration, use the Get-PSSessionConfiguration cmdlet or the WSMan Provider. For 
more information about the WSMan Provider, type "Get-Help WSMan".