Set-PSSessionConfiguration

Ändert die Eigenschaften einer registrierten Sitzungskonfiguration.

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>]

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das Set-PSSessionConfiguration Cmdlet ändert die Eigenschaften der Sitzungskonfigurationen auf dem lokalen Computer.

Verwenden Sie den Name-Parameter, um die Sitzungskonfiguration zu identifizieren, die Sie ändern möchten. Verwenden Sie die anderen Parameter, um neue Werte für die Eigenschaften der Sitzungskonfiguration anzugeben. Um einen Eigenschaftswert aus der Konfiguration zu löschen und den Standardwert zu verwenden, geben Sie eine leere Zeichenfolge ("") oder einen Wert $Null für den entsprechenden Parameter ein.

Ab PowerShell 3.0 können Sie eine Sitzungskonfigurationsdatei verwenden, um eine Sitzungskonfiguration zu definieren. Diese Funktion bietet eine einfache und sichtbare Methode für das Festlegen und Ändern der Eigenschaften von Sitzungen, die die Sitzungskonfiguration verwenden. Um eine Sitzungskonfigurationsdatei anzugeben, verwenden Sie den Path-Parameter von Set-PSSessionConfiguration. Informationen zu Sitzungskonfigurationsdateien finden Sie unter about_Session_Configuration_Files. Informationen zum Erstellen und Ändern einer Sitzungskonfigurationsdatei finden Sie im New-PSSessionConfigurationFile Cmdlet.

Sitzungskonfigurationen definieren die Umgebung von Remotesitzungen (PSSessions), die eine Verbindung mit dem lokalen Computer herstellen. Jede PSSession verwendet eine Sitzungskonfiguration. Die Sitzungskonfiguration bestimmt die Features der PSSession, z. B. die Module, die in der Sitzung verfügbar sind, die Cmdlets, die ausgeführt werden dürfen, den Sprachmodus, Kontingente und Timeouts. Der Sicherheitsdeskriptor der Sitzungskonfiguration bestimmt, wer die Sitzungskonfiguration verwenden kann, um eine Verbindung mit dem lokalen Computer herzustellen. Weitere Informationen zu Sitzungskonfigurationen finden Sie unter about_Session_Configurations.

Verwenden Sie das Get-PSSessionConfiguration Cmdlet oder den WSMan-Anbieter, um die Eigenschaften einer Sitzungskonfiguration anzuzeigen. Geben Sie weitere Informationen zum WSMan-Anbieter ein Get-Help WSMan.

Beispiele

Beispiel 1: Erstellen und Ändern einer Sitzungskonfiguration

In diesem Beispiel wird gezeigt, wie Sie ein Startskript aus einer Konfiguration hinzufügen und entfernen.

Der erste Befehl erstellt die AdminShell-Konfiguration . Der zweite Befehl fügt das AdminConfig.ps1 Skript der Konfiguration hinzu. Die Änderung ist wirksam, wenn Sie WinRM neu starten. Der dritte Befehl entfernt das AdminConfig.ps1 Skript aus der Konfiguration.

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

Beispiel 2: Anzeigen von Ergebnissen

In diesem Beispiel wird der Wert der MaximumReceivedObjectSizeMB-Eigenschaft auf 20. Dieser Befehl fordert Sie außerdem auf, den WinRM-Dienst neu zu starten. Die Änderung ist erst wirksam, wenn der WinRM-Dienst neu gestartet wird.

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

Beispiel 3: Anzeigen von Ergebnissen auf unterschiedliche Weise

Ändert in diesem Beispiel Set-PSSessionConfiguration das Startskript in der MaintenanceShell-Sitzungskonfiguration in Maintenance.ps1. Die Ausgabe zeigt die Änderung und fordert Sie auf, den WinRM-Dienst neu zu starten. Die Antwort lautet y (ja).

Get-PSSessionConfiguration ruft die MaintenanceShell-Sitzungskonfiguration ab. Der Pipelineoperator (|) sendet die Ergebnisse des Befehls an Format-List, an das alle Eigenschaften des Konfigurationsobjekts in einer Liste angezeigt werden. Als Nächstes zeigen wir mithilfe des WSMan-Anbieters die Initialisierungsparameter für die MaintenanceShell-Konfiguration an. Get-ChildItem ruft die untergeordneten Elemente im InitializationParameters-Knoten für das MaintenanceShell-Plug-In ab. Geben Sie weitere Informationen zum WSMan-Anbieter ein 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

Parameter

-AccessMode

Aktiviert und deaktiviert die Sitzungskonfiguration und bestimmt, ob sie für Remote- oder lokale Sitzungen auf dem Computer verwendet werden kann. Zulässige Werte für diesen Parameter:

  • Disabled. Deaktiviert die Sitzungskonfiguration. Sie kann nicht für Remote- oder lokalen Zugriff auf den Computer verwendet werden. Dieser Wert legt die Enabled-Eigenschaft der Sitzungskonfiguration (WSMan:\<ComputerName>\PlugIn\<SessionConfigurationName>\Enabled) auf False.
  • Local. Fügt der Sicherheitsbeschreibung der Sitzungskonfiguration einen Network_Deny_All-Eintrag hinzu. Benutzer des lokalen Computers können die Sitzungskonfiguration verwenden, um eine lokale Loopbacksitzung auf demselben Computer zu erstellen, Remotebenutzer werden jedoch zugriff verweigert.
  • Remote. Entfernt die Einträge Deny_All und Network_Deny_All aus den Sicherheitsbeschreibungen der Sitzungskonfiguration. Benutzer von lokalen Computern und Remotecomputern können die Sitzungskonfiguration verwenden, um Sitzungen zu erstellen und um Befehle auf diesem Computer auszuführen.

Der Standardwert ist Remote.

Andere Cmdlets können den Wert dieses Parameters später außer Kraft setzen. Das Cmdlet ermöglicht beispielsweise Enable-PSRemoting alle Sitzungskonfigurationen auf dem Computer und ermöglicht remoteen Zugriff darauf, und das Disable-PSRemoting Cmdlet erlaubt nur lokalen Zugriff auf alle Sitzungskonfigurationen auf dem Computer.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:PSSessionConfigurationAccessMode
Accepted values:Disabled, Local, Remote
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationBase

Gibt den Pfad der Assemblydatei (*.dll) an, die im Wert des AssemblyName-Parameters angegeben ist.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AssemblyName

Gibt den Assemblynamen an. Dieses Cmdlet erstellt eine Sitzungskonfiguration basierend auf einer Klasse, die in einer Assembly definiert ist.

Geben Sie den Dateinamen oder vollständigen Pfad einer Assemblydatei .dll ein, die eine Sitzungskonfiguration definiert. Wenn Sie nur den Dateinamen eingeben, können Sie den Pfad im Wert des ApplicationBase-Parameters eingeben.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ConfigurationTypeName

Gibt den Typ der Sitzungskonfiguration an, der in der Assembly im AssemblyName-Parameter definiert ist. Der Typ, den Sie angeben, muss die System.Management.Automation.Remoting.PSSessionConfigurationKlasse implementieren.

Dieser Parameter ist erforderlich, wenn Sie den Namen einer Assembly angeben.

Type:String
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Unterdrückt alle Benutzeraufforderungen und startet den WinRM-Dienst ohne Aufforderung neu. Durch Neustarten des Diensts wird die Konfigurationsänderung übernommen.

Um einen Neustart zu verhindern und die Aufforderung zum Neustart zu unterdrücken, verwenden Sie den NoServiceRestart-Parameter.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaximumReceivedDataSizePerCommandMB

Gibt den Grenzwert für die Datenmenge an, die in einem einzelnen Remotebefehl an diesen Computer gesendet werden kann. Geben Sie die Datengröße in Megabyte (MB) ein. Der Standardwert lautet 50.

Wenn ein Grenzwert für die Datengröße im Konfigurationstyp definiert ist, der im ConfigurationTypeName-Parameter angegeben ist, wird der Grenzwert im Konfigurationstyp verwendet. Der Wert dieses Parameters wird ignoriert.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-MaximumReceivedObjectSizeMB

Gibt die Grenzwerte für die Datenmenge an, die in jedem einzelnen Objekt an diesen Computer gesendet werden kann. Geben Sie die Datengröße in Megabyte ein. Der Standardwert lautet 10.

Wenn ein Objektgrößenlimit im Konfigurationstyp definiert ist, der im ConfigurationTypeName-Parameter angegeben ist, wird der Grenzwert im Konfigurationstyp verwendet. Der Wert dieses Parameters wird ignoriert.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ModulesToImport

Gibt die Module und Snap-ins an, die automatisch in Sitzungen importiert werden, die die Sitzungskonfiguration verwenden. Geben Sie die Namen der Module und Snap-Ins ein.

Standardmäßig wird nur das Microsoft.PowerShell.Core-Modul in Sitzungen importiert, es sei denn, die Cmdlets sind ausgeschlossen, können Sie die Import-Module Module Add-PSSnapin und Cmdlets verwenden, um der Sitzung Module und Snap-Ins hinzuzufügen.

Die in diesem Parameterwert angegebenen Module werden zusätzlich zu Modulen importiert, die in der Sitzungskonfigurationsdatei (New-PSSessionConfigurationFile) angegeben sind. Einstellungen in der Sitzungskonfigurationsdatei können jedoch die von Modulen exportierten Befehle ausblenden oder verhindern, dass Benutzer sie verwenden.

Die in diesem Parameterwert angegebenen Module ersetzen die Liste der Module, die durch den ModulesToImport-Parameter des Register-PSSessionConfiguration Cmdlets angegeben sind.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:Object[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt den Namen der Sitzungskonfiguration an, die Sie ändern möchten.

Sie können diesen Parameter verwenden, um den Namen der Sitzungskonfiguration zu ändern.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-NoServiceRestart

Startet den WinRM-Dienst nicht neu und unterdrückt die Eingabeaufforderung, um den Dienst neu zu starten.

Standardmäßig werden Sie Set-PSSessionConfigurationaufgefordert, den WinRM-Dienst neu zu starten, um die neue Sitzungskonfiguration wirksam zu machen. Bis der WinRM-Dienst neu gestartet wird, ist die neue Sitzungskonfiguration nicht wirksam.

Verwenden Sie den Parameter Force, um den WinRM-Dienst ohne Aufforderung neu zu starten. Verwenden Sie das Restart-Service Cmdlet, um den WinRM-Dienst manuell neu zu starten.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Path

Gibt den Pfad einer Sitzungskonfigurationsdatei (.pssc) an, z. B. einen vom Cmdlet erstellten New-PSSessionConfigurationFile . Wenn Sie den Pfad weglassen, ist die Standardeinstellung das aktuelle Verzeichnis.

Informationen zum Ändern einer Sitzungskonfigurationsdatei finden Sie im Hilfethema für das New-PSSessionConfigurationFile Cmdlet.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PSVersion

Gibt die Version von PowerShell in Sitzungen an, die diese Sitzungskonfiguration verwenden.

Der Wert dieses Parameters hat Vorrang vor den Wert des PowerShellVersion-Schlüssels in der Sitzungskonfigurationsdatei.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:Version
Aliases:PowerShellVersion
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RunAsCredential

Gibt Anmeldeinformationen für Befehle in der Sitzung an. Standardmäßig werden Befehle mit den Berechtigungen des aktuellen Benutzers ausgeführt.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SecurityDescriptorSddl

Gibt eine andere Security Descriptor Definition Language (SDDL)-Zeichenfolge für die Konfiguration an.

Diese Zeichenfolge bestimmt die Berechtigungen, die erforderlich sind, um die Konfiguration für die neue Sitzung zu verwenden. Um eine Sitzungskonfiguration in einer Sitzung zu verwenden, müssen Benutzer mindestens Execute(Invoke) über die Berechtigung für die Konfiguration verfügen.

Um den Standardsicherheitsdeskriptor für die Konfiguration zu verwenden, geben Sie eine leere Zeichenfolge ("") oder einen Wert von $Null. Der Standardwert ist die Stamm-SDDL auf dem WSMan: Laufwerk.

Wenn der Sicherheitsdeskriptor komplex ist, sollten Sie anstelle dieses Parameters den Parameter ShowSecurityDescriptorUI verwenden. Sie können nicht beide Parameter im selben Befehl verwenden.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SessionTypeOption

Gibt typspezifische Optionen für die Sitzungskonfiguration an. Geben Sie ein Sitzungstypoptionenobjekt ein, z. B. das PSWorkflowExecutionOption -Objekt, das das New-PSWorkflowExecutionOption Cmdlet zurückgibt.

Die Optionen der Sitzungen, die die Sitzungskonfiguration verwenden, werden durch die Werte der Sitzungsoptionen und die Sitzungskonfigurationsoptionen bestimmt. Sofern nicht angegeben, haben Optionen, die in der Sitzung festgelegt sind, z. B. mit dem New-PSSessionOption Cmdlet, Vorrang vor optionen, die in der Sitzungskonfiguration festgelegt sind. Die Sitzungsoptionswerte dürfen aber nicht die in der Sitzungskonfiguration festgelegten Höchstwerte überschreiten.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:PSSessionTypeOption
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ShowSecurityDescriptorUI

Wenn dieser Parameter verwendet wird, öffnet das Cmdlet ein Eigenschaftenblatt, mit dem Sie eine neue SDDL für die Sitzungskonfiguration erstellen können. Das Eigenschaftenblatt wird angezeigt, nachdem Sie den Set-PSSessionConfiguration Befehl ausgeführt haben und dann den WinRM-Dienst neu starten.

Wenn Sie Berechtigungen für die Konfiguration festlegen, denken Sie daran, dass Benutzer mindestens Execute(Invoke) über die Berechtigung zum Verwenden der Sitzungskonfiguration in einer Sitzung verfügen müssen.

Sie können den SecurityDescriptorSDDL-Parameter und diesen Parameter nicht im selben Befehl verwenden.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-StartupScript

Gibt das Startskript für die Konfiguration an. Geben Sie den vollqualifizierten Pfad eines PowerShell-Skripts ein. Das angegebene Skript wird in der neuen Sitzung ausgeführt, die die Sitzungskonfiguration verwendet.

Um ein Startskript aus einer Sitzungskonfiguration zu löschen, geben Sie eine leere Zeichenfolge ("") oder einen Wert von $Null.

Sie können ein Startskript verwenden, um die Benutzersitzung weiter zu konfigurieren. Wenn das Skript einen Fehler generiert, wird auch ein nicht beendeter Fehler generiert, wird die Sitzung nicht erstellt, und der New-PSSession Befehl schlägt fehl.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ThreadApartmentState

Gibt den Wohnungszustand des zu verwendenden Threadingmoduls an. Zulässige Werte sind:

  • Unknown
  • MTA
  • STA
Type:ApartmentState
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ThreadOptions

Gibt die Einstellung der Threadoptionen in der Konfiguration an. Diese Einstellung definiert, wie Threads erstellt und verwendet werden, wenn ein Befehl in der Sitzung ausgeführt wird. Zulässige Werte für diesen Parameter:

  • Default
  • ReuseThread
  • UseCurrentThread
  • UseNewThread

Standardwert: UseCurrentThread.

Weitere Informationen finden Sie unter PSThreadOptions-Enumeration.

Type:PSThreadOptions
Accepted values:Default, UseNewThread, ReuseThread, UseCurrentThread
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TransportOption

Gibt die Transportoptionen für die Sitzungskonfiguration an. Geben Sie ein Transportoptionenobjekt ein, z. B. das WSManConfigurationOption -Objekt, das das New-PSTransportOption Cmdlet zurückgibt.

Die Optionen der Sitzungen, die die Sitzungskonfiguration verwenden, werden durch die Werte der Sitzungsoptionen und die Sitzungskonfigurationsoptionen bestimmt. Sofern nicht angegeben, haben Optionen, die in der Sitzung festgelegt sind, z. B. mit dem New-PSSessionOption Cmdlet, Vorrang vor optionen, die in der Sitzungskonfiguration festgelegt sind. Die Sitzungsoptionswerte dürfen aber nicht die in der Sitzungskonfiguration festgelegten Höchstwerte überschreiten.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:PSTransportOption
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseSharedProcess

Verwenden Sie nur einen Prozess, um alle Sitzungen zu hosten, die vomselben Benutzer gestartet werden und dieselbe Sitzungskonfiguration verwenden. Standardmäßig wird jede Sitzung in einem eigenen Prozess gehostet.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Eingaben können nicht an dieses Cmdlet weitergereicht werden.

Ausgaben

Microsoft.WSMan.Management.WSManConfigLeafElement

Hinweise

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.

Um dieses Cmdlet auszuführen, starten Sie PowerShell mithilfe der Option "Als Administrator ausführen".

Das Set-PSSessionConfiguration Cmdlet ändert den Konfigurationsnamen nicht, und der WSMan-Anbieter unterstützt das Rename-Item Cmdlet nicht. Um den Namen einer Sitzungskonfiguration zu ändern, verwenden Sie das Unregister-PSSessionConfiguration Cmdlet, um die Konfiguration zu löschen und dann das Register-PSSessionConfiguration Cmdlet zum Erstellen und Registrieren einer neuen Sitzungskonfiguration zu verwenden.

Sie können das Set-PSSessionConfiguration Cmdlet verwenden, um die Standard Microsoft.PowerShell - und Microsoft.PowerShell32 Sitzungskonfigurationen zu ändern. Sie sind nicht geschützt. Um zur ursprünglichen Version einer Standardsitzungskonfiguration zurückzusetzen, verwenden Sie das Unregister-PSSessionConfiguration Cmdlet, um die Standardsitzungskonfiguration zu löschen, und verwenden Sie dann das Enable-PSRemoting Cmdlet, um sie wiederherzustellen.

Die Eigenschaften eines Sitzungskonfigurationsobjekts weichen hinsichtlich der für die Sitzungskonfiguration festgelegten Optionen sowie der Werte dieser Optionen ab. Sitzungskonfigurationen, die eine Sitzungskonfigurationsdatei verwenden, haben außerdem zusätzliche Eigenschaften.

Sie können Befehle im WSMan: Laufwerk verwenden, um die Eigenschaften von Sitzungskonfigurationen zu ändern. Sie können das WSMan: Laufwerk in PowerShell 2.0 jedoch nicht verwenden, um Sitzungskonfigurationseigenschaften zu ändern, die in PowerShell 3.0 eingeführt werden, z. B. OutputBufferingMode. Windows PowerShell 2.0-Befehle generieren keine Fehler, aber sie sind wirkungslos. Verwenden Sie zum Ändern der in PowerShell 3.0 eingeführten Eigenschaften das WSMan: Laufwerk in PowerShell 3.0 oder höher.