Freigeben über

Set-PSSessionConfiguration

  • Referenz
Modul:
Microsoft.PowerShell.Core

Ä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

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

Um die Eigenschaften einer Sitzungskonfiguration anzuzeigen, verwenden Sie das Get-PSSessionConfiguration Cmdlet oder den WSMan-Anbieter. Um weitere Informationen zum WSMan-Anbieter zu erfahren, geben Sie ein Get-Help WSMan.

Beispiele

Beispiel 1: Ändern des Thread-Apartmentzustands

PS C:\> Set-PSSessionConfiguration -Name "MaintenanceShell" -ThreadApartmentState STA

Dieser Befehl ändert den Threadapartmentzustand in der MaintenanceShell-Konfiguration in „STA“. Die Änderung wird wirksam, wenn Sie den WinRM-Dienst neu starten.

Beispiel 2: Create und Ändern einer Sitzungskonfiguration

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

Mit dem ersten Befehl wird die AdminShell-Konfiguration erstellt. Der zweite Befehl fügt das AdminConfig.ps1 Skript der Konfiguration hinzu. Die Änderung wird 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 3: Anzeigen von Ergebnissen

In diesem Beispiel wird der Wert der MaximumReceivedObjectSizeMB-Eigenschaft auf 20 erhöht. 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 4: 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 und fordert Sie auf, den WinRM-Dienst neu zu starten. Die Antwort ist „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 zeigen wir mithilfe des WSMan-Anbieters die Initialisierungsparameter für die MaintenanceShell-Konfiguration an. Get-ChildItem (Alias dir) 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.

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

PS> Get-PSSessionConfiguration MaintenanceShell | Format-List -Property *

xmlns            : https://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      : https://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch       : true
Capability       : {Shell}
Permission       :

PS> dir 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:

  • Deaktiviert. 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 fest.
  • Lokal. 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 überschreiben. 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, die 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 Assembly .dll Datei 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 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
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 ist 50 MB.

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: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 ist 10 MB.

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

Type: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-Snap-In in Sitzungen importiert. Wenn die Cmdlets jedoch nicht ausgeschlossen sind, 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 in Ergänzungen 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 mit dem ModulesToImport-Parameter des Register-PSSessionConfiguration Cmdlets angegeben wurden.

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 Neustarten des Diensts.

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 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 (PSSC) an, z. B. einer sitzungskonfigurationsdatei, 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 über die Berechtigung Execute(Invoke) für die Konfiguration verfügen.

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

Wenn der Sicherheitsdeskriptor komplex ist, sollten Sie den ShowSecurityDescriptorUI-Parameter anstelle dieses 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 Optionsobjekt vom Sitzungstyp 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. mithilfe des New-PSSessionOption Cmdlets, 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowSecurityDescriptorUI

Gibt an, dass dieses Cmdlet ein Eigenschaftenblatt ist, 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 über die Berechtigung Execute(Invoke) verfügen müssen, um die Sitzungskonfiguration in einer Sitzung verwenden zu können.

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 $Nullein.

Sie können ein Startskript verwenden, um die Benutzersitzung weiter zu konfigurieren. Wenn das Skript einen Fehler generiert, sogar einen Fehler, der nicht beendet wird, 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 die Einstellung für den Apartmentzustand für die Threads in der Sitzung an. Die zulässigen Werte für diesen Parameter sind: STA, MTA und Unknown. Der Standardwert ist Unknown (Unbekannt).

Type:ApartmentState
Accepted values:STA, MTA, Unknown
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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:

  • Standard
  • ReuseThread
  • UseCurrentThread
  • UseNewThread

Der Standardwert ist 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 vom Cmdlet zurückgegebene WSManConfigurationOption-ObjektNew-PSTransportOption.

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. mithilfe des New-PSSessionOption Cmdlets, 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSharedProcess

Verwenden Sie nur einen Prozess, um alle Sitzungen zu hosten, die vom gleichen 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

Eingaben können nicht an dieses Cmdlet weitergereicht werden.

Ausgaben

WSManConfigLeafElement

Hinweise

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

Der Set-PSSessionConfiguration Konfigurationsname wird vom Cmdlet nicht geändert, 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 Standardkonfigurationen der Microsoft.PowerShell- und Microsoft.PowerShell32-Sitzung 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 jedoch das Laufwerk WSMan: in PowerShell 2.0 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 Laufwerk WSMan: in PowerShell 3.0.