Freigeben über


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 von $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. Verwenden Sie zum Angeben einer Sitzungskonfigurationsdatei 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 in der Sitzung verfügbaren Module, die Cmdlets, die ausgeführt werden dürfen, den Sprachmodus, Kontingente und Timeouts. Die Sicherheitsbeschreibung 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 Cmdlet oder den WSMan-Anbieter, um die Get-PSSessionConfiguration Eigenschaften einer Sitzungskonfiguration anzuzeigen. Um weitere Informationen zum WSMan-Anbieter zu erfahren, geben Sie ein Get-Help WSMan.

Beispiele

Beispiel 1: Create und Ändern einer Sitzungskonfiguration

In diesem Beispiel wird das Hinzufügen und Entfernen eines Startskripts aus einer Konfiguration veranschaulicht.

Mit dem ersten Befehl wird die AdminShell-Konfiguration erstellt. Mit dem zweiten Befehl wird das AdminConfig.ps1 Skript der Konfiguration hinzugefügt. Die Änderung ist wirksam, wenn Sie WinRM neu starten. Mit dem dritten Befehl wird das AdminConfig.ps1 Skript aus der Konfiguration entfernt.

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 erhöht 20. Mit diesem Befehl werden Sie außerdem aufgefordert, 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

In diesem Beispiel Set-PSSessionConfiguration ändert das Startskript in der MaintenanceShell-Sitzungskonfiguration in Maintenance.ps1. Die Ausgabe zeigt die Änderung an 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, der alle Eigenschaften des Konfigurationsobjekts in einer Liste anzeigt. Als Nächstes werden mithilfe des WSMan-Anbieters die Initialisierungsparameter für die MaintenanceShell-Konfiguration angezeigt. Get-ChildItem ruft die untergeordneten Elemente im Knoten InitializationParameters für das MaintenanceShell-Plug-In ab. Um weitere Informationen zum WSMan-Anbieter zu erfahren, geben Sie 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 fest 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, aber Remotebenutzern wird der 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. Beispielsweise ermöglicht das Enable-PSRemoting Cmdlet alle Sitzungskonfigurationen auf dem Computer und den Remotezugriff auf sie, und das Disable-PSRemoting Cmdlet lässt nur lokalen Zugriff auf alle Sitzungskonfigurationen auf dem Computer zu.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

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

-ApplicationBase

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

Type:String
Position:Named
Default value:None
Required:False
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
Required:True
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
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Unterdrückt alle Benutzereingabeaufforderungen 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
Required:False
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 in dem Konfigurationstyp, der im Parameter ConfigurationTypeName angegeben ist, ein Grenzwert für die Datengröße definiert ist, wird der Grenzwert im Konfigurationstyp verwendet. Der Wert dieses Parameters wird ignoriert.

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

-MaximumReceivedObjectSizeMB

Gibt die Grenzwerte für die Datenmenge an, die in einem 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 Parameter ConfigurationTypeName angegeben ist, wird der Grenzwert im Konfigurationstyp verwendet. Der Wert dieses Parameters wird ignoriert.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
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, aber wenn die Cmdlets nicht ausgeschlossen werden, können Sie die Import-Module Cmdlets und Add-PSSnapin 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 angegebenen Module durch den ModulesToImport-Parameter des Register-PSSessionConfiguration Cmdlets.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:Object[]
Position:Named
Default value:None
Required:False
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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoServiceRestart

Startet den WinRM-Dienst nicht neu und unterdrückt die Aufforderung zum Neustart des Diensts.

Wenn Sie ausführen Set-PSSessionConfiguration, werden Sie standardmäßig aufgefordert, 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 Force-Parameter, um den WinRM-Dienst ohne Aufforderung neu zu starten. Verwenden Sie Restart-Service das Cmdlet, um den WinRM-Dienst manuell neu zu starten.

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

-Path

Gibt den Pfad einer Sitzungskonfigurationsdatei () an,.pssc z. B. einer sitzungsbasierten Datei, die New-PSSessionConfigurationFile vom Cmdlet erstellt wurde. 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
Required:True
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
Required:False
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
Required:False
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 verwenden zu können, müssen Benutzer mindestens Execute(Invoke) über die Berechtigung für die Konfiguration verfügen.

Um die Standardsicherheitsbeschreibung für die Konfiguration zu verwenden, geben Sie eine leere Zeichenfolge ("") oder einen Wert von ein $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
Required:False
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 VOM Cmdlet zurückgegebene PSWorkflowExecutionOption-ObjektNew-PSWorkflowExecutionOption.

Die Optionen der Sitzungen, die die Sitzungskonfiguration verwenden, werden durch die Werte der Sitzungsoptionen und die Sitzungskonfigurationsoptionen bestimmt. Sofern nicht angegeben, haben in der Sitzung festgelegte Optionen, z. B. mit dem New-PSSessionOption Cmdlet, Vorrang vor den in der Sitzungskonfiguration festgelegten Optionen. 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
Required:False
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 und den WinRM-Dienst neu gestartet haben.

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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 ein $Null.

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

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

-ThreadApartmentState

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

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

-ThreadOptions

Gibt die Threadoptioneneinstellung 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
Required:False
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 in der Sitzung festgelegte Optionen, z. B. mit dem New-PSSessionOption Cmdlet, Vorrang vor den in der Sitzungskonfiguration festgelegten Optionen. 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
Required:False
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 verwenden Sie die gleiche Sitzungskonfiguration. 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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet übergeben.

Ausgaben

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 verwenden Sie dann das Register-PSSessionConfiguration Cmdlet, um eine neue Sitzungskonfiguration zu erstellen und zu registrieren.

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 die ursprüngliche Version einer Standardsitzungskonfiguration zu rückgängig machen, 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. Um die in PowerShell 3.0 eingeführten Eigenschaften zu ändern, verwenden Sie das WSMan: Laufwerk in PowerShell 3.0 oder höher.