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 Parameter Name , 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. Weitere Informationen zum WSMan-Anbieter geben Sie Get-Help WSManein.

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. 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 wird 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 die 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 Knoten InitializationParameters 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 einen Network_Deny_All Eintrag zur Sicherheitsbeschreibung der Sitzungskonfiguration hinzu. Benutzer des lokalen Computers können die Sitzungskonfiguration verwenden, um eine lokale Loopbacksitzung auf demselben Computer zu erstellen, Remotebenutzer haben jedoch den Zugriff verweigert.
  • Remote. Entfernt Deny_All und Network_Deny_All Einträge 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 aktiviert beispielsweise Enable-PSRemoting alle Sitzungskonfigurationen auf dem Computer und ermöglicht den Remotezugriff 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.

Typ:PSSessionConfigurationAccessMode
Zulässige Werte:Disabled, Local, Remote
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ApplicationBase

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConfigurationTypeName

Gibt den Typ der Sitzungskonfiguration an, die in der Assembly im AssemblyName-Parameter definiert ist. Der von Ihnen angegebene Typ muss die System.Management.Automation.Remoting.PSSessionConfiguration-Klasse implementieren.

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

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 Neustartaufforderung zu unterdrücken, verwenden Sie den Parameter NoServiceRestart .

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaximumReceivedDataSizePerCommandMB

Gibt den Grenzwert für die Datenmenge an, die in jedem einzelnen Remotebefehl an diesen Computer gesendet werden kann. Geben Sie die Datengröße in Megabyte (MB) ein. Der Standardwert ist 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.

Typ:Nullable<T>[Double]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 ist 10.

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

Typ:Nullable<T>[Double]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 Module Add-PSSnapin und Snap-Ins der Sitzung mithilfe der Import-Module Cmdlets und Cmdlets hinzufü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.

Typ:Object[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NoServiceRestart

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

Wenn Sie ausführen Set-PSSessionConfiguration, werden Sie standardmäßig aufgefordert, den WinRM-Dienst neu zu starten, damit die neue Sitzungskonfiguration wirksam wird. 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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Pfad einer Sitzungskonfigurationsdatei (.pssc) an, z. B. einen, der 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 zum New-PSSessionConfigurationFile Cmdlet.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PSVersion

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

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

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Typ:Version
Aliase:PowerShellVersion
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 Die 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 ShowSecurityDescriptorUI-Parameter verwenden. Sie können nicht beide Parameter im selben Befehl verwenden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SessionTypeOption

Gibt typspezifische Optionen für die Sitzungskonfiguration an. Geben Sie ein Sitzungstyp-Optionsobjekt ein, z. B. das vom Cmdlet zurückgegebene New-PSWorkflowExecutionOption PSWorkflowExecutionOption-Objekt.

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.

Typ:PSSessionTypeOption
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 dann 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 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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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, selbst ein nicht beendeter Fehler, wird die Sitzung nicht erstellt, und der New-PSSession Befehl schlägt fehl.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ThreadApartmentState

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

  • Unknown
  • MTA
  • STA
Typ:ApartmentState
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ThreadOptions

Gibt die Einstellung für 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

Der Standardwert ist UseCurrentThread.

Weitere Informationen finden Sie unter PSThreadOptions-Aufzählung.

Typ:PSThreadOptions
Zulässige Werte:Default, UseNewThread, ReuseThread, UseCurrentThread
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TransportOption

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

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.

Typ:PSTransportOption
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseSharedProcess

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

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

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 nicht den Konfigurationsnamen, und der WSMan-Anbieter unterstützt das Rename-Item Cmdlet nicht. Verwenden Sie zum Ändern des Namens einer Sitzungskonfiguration 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. Verwenden Sie zum Wiederherstellen der ursprünglichen Version einer Standardsitzungskonfiguration 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 in PowerShell 3.0 eingeführte Eigenschaften zu ändern, verwenden Sie das WSMan: Laufwerk in PowerShell 3.0 oder höher.