Contact Info

Crumbtrail » Administration » Powershell » Powershell 3.0 » Register-PSSessionConfiguration

Register-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
Creates and registers a new session configuration.

Register-PSSessionConfiguration [-Name] <String> [-AccessMode <PSSessionConfigurationAccessMode>] [-ApplicationBase <St
ring>] [-Force] [-MaximumReceivedDataSizePerCommandMB <Double>] [-MaximumReceivedObjectSizeMB <Double>] [-ModulesToImpo
rt <String[]>] [-NoServiceRestart] [-ProcessorArchitecture <String>] [-PSVersion <Version>] [-RunAsCredential <PSCreden
tial>] [-SecurityDescriptorSddl <String>] [-SessionType <PSSessionType>] [-SessionTypeOption <PSSessionTypeOption>] [-S
howSecurityDescriptorUI] [-StartupScript <String>] [-ThreadApartmentState <ApartmentState>] [-ThreadOptions <PSThreadOp
tions>] [-TransportOption <PSTransportOption>] [-UseSharedProcess] [-Confirm] [-WhatIf] [<CommonParameters>]
Register-PSSessionConfiguration [-Name] <String> [-AssemblyName] <String> [-ConfigurationTypeName] <String> [-AccessMod
e <PSSessionConfigurationAccessMode>] [-ApplicationBase <String>] [-Force] [-MaximumReceivedDataSizePerCommandMB <Doubl
e>] [-MaximumReceivedObjectSizeMB <Double>] [-ModulesToImport <String[]>] [-NoServiceRestart] [-ProcessorArchitecture <
String>] [-PSVersion <Version>] [-RunAsCredential <PSCredential>] [-SecurityDescriptorSddl <String>] [-SessionTypeOptio
n <PSSessionTypeOption>] [-ShowSecurityDescriptorUI] [-StartupScript <String>] [-ThreadApartmentState <ApartmentState>]
 [-ThreadOptions <PSThreadOptions>] [-TransportOption <PSTransportOption>] [-UseSharedProcess] [-Confirm] [-WhatIf] [<C
Register-PSSessionConfiguration [-Name] <String> [-AccessMode <PSSessionConfigurationAccessMode>] [-Force] [-MaximumRec
eivedDataSizePerCommandMB <Double>] [-MaximumReceivedObjectSizeMB <Double>] [-NoServiceRestart] [-ProcessorArchitecture
 <String>] [-RunAsCredential <PSCredential>] [-SecurityDescriptorSddl <String>] [-ShowSecurityDescriptorUI] [-StartupSc
ript <String>] [-ThreadApartmentState <ApartmentState>] [-ThreadOptions <PSThreadOptions>] [-TransportOption <PSTranspo
rtOption>] [-UseSharedProcess] -Path <String> [-Confirm] [-WhatIf] [<CommonParameters>]

The Register-PSSessionConfiguration cmdlet creates and registers a  new session configuration on the local computer. Th
is is an advanced cmdlet that is designed to be used by system administrators to create custom sessions for remote user

Every Windows PowerShell session (PSSession) uses a session configuration, also known as an "endpoint." When users crea
te a session that connects to the computer, they can select a session configuration or use the default session configur
ation that is registered when you enable Windows PowerShell remoting. Users can also set the $PSSessionConfigurationNam
e preference variable, which specifies a default configuration for remote sessions created in the current session.

The session configuration defines the environment for the remote session. The configuration can determine which command
s and language elements are available in the session, and it can include settings that protect the computer, such as th
ose that limit the amount of data that the session can receive remotely in a single object or command.  The security de
scriptor (ACL) of the session configuration determines which users have permission to use the session configuration.

You can define the elements of configuration by using an assembly that implements a new configuration class and by usin
g a script that runs in the session. Beginning in Windows PowerShell 3.0, you can also use a session configuration file
 to define the session configuration.

For information about session configurations, see about_Session_Configurations (
145152). For information about session configuration files, see about_Session_Configuration_Files (