Set-PSSessionConfiguration

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 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: Ä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 ist wirksam, wenn Sie den WinRM-Dienst neu starten.

Beispiel 2: 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 3: 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

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

WSManConfigLeafElement

Hinweise

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.

Ähnliche Themen

• Disable-PSSessionConfiguration
• Enable-PSSessionConfiguration
• Get-PSSessionConfiguration
• New-PSSessionConfigurationFile
• New-PSSessionOption
• New-PSTransportOption
• New-PSWorkflowExecutionOption
• Register-PSSessionConfiguration
• Test-PSSessionConfigurationFile
• Unregister-PSSessionConfiguration
• WSMan-Anbieter
• about_Session_Configurations
• about_Session_Configuration_Files