Register-PSSessionConfiguration

Referenz

Modul:: Microsoft.PowerShell.Core

Erstellt und registriert eine neue Sitzungskonfiguration.

Syntax

Register-PSSessionConfiguration
        [-ProcessorArchitecture <String>]
        [-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>]

Register-PSSessionConfiguration
        [-ProcessorArchitecture <String>]
        [-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>]

Register-PSSessionConfiguration
        [-ProcessorArchitecture <String>]
        [-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 Register-PSSessionConfiguration Cmdlet erstellt und registriert eine neue Sitzungskonfiguration auf dem lokalen Computer. Dies ist ein erweitertes Cmdlet, mit dem Sie benutzerdefinierte Sitzungen für Remotebenutzer erstellen können.

Jede PowerShell-Sitzung (PSSession) verwendet eine Sitzungskonfiguration, auch als Endpunkt bezeichnet. Wenn Benutzer eine Sitzung erstellen, die eine Verbindung mit dem Computer herstellt, können sie eine Sitzungskonfiguration auswählen oder die Standardsitzungskonfiguration verwenden, die beim Aktivieren von PowerShell-Remoting registriert ist. Benutzer können auch die $PSSessionConfigurationName Einstellungsvariable festlegen, die eine Standardkonfiguration für Remotesitzungen angibt, die in der aktuellen Sitzung erstellt wurden.

Die Sitzungskonfiguration definiert die Umgebung für die Remotesitzung. Die Konfiguration kann festlegen, welche Befehle und Sprachelemente in der Sitzung verfügbar sind und Einstellungen zum Schutz des Computers enthalten, wie z. B. Beschränkungen der Datenmenge, die von der Sitzung remote in einem einzigen Objekt oder Befehl empfangen werden kann. Der Sicherheitsdeskriptor der Sitzungskonfiguration bestimmt, welche Benutzer über die Berechtigung zum Verwenden der Sitzungskonfiguration verfügen.

Sie können die Elemente der Konfiguration mit einer Assembly definieren, die eine neue Konfigurationsklasse implementiert, sowie mithilfe eines Skripts, das in der Sitzung ausgeführt wird. Ab PowerShell 3.0 können Sie auch eine Sitzungskonfigurationsdatei verwenden, um die Sitzungskonfiguration zu definieren.

Informationen zu Sitzungskonfigurationen finden Sie unter about_Session_Configurations. Informationen zu Sitzungskonfigurationsdateien finden Sie unter about_Session_Configuration_Files.

Beispiele

Beispiel 1: Registrieren einer NewShell-Sitzungskonfiguration

In diesem Beispiel registrieren wir die NewShell-Sitzungskonfiguration . Die Parameter "AssemblyName " und "ApplicationBase " geben den Speicherort der MyShell.dll-Datei an, die die Cmdlets und Anbieter in der Sitzungskonfiguration angibt. Der Parameter ConfigurationTypeName gibt die konfigurationsklasse an, die aus der Assembly verwendet werden soll.

$sessionConfiguration = @{
    Name='NewShell'
    ApplicationBase='c:\MyShells\'
    AssemblyName='MyShell.dll'
    ConfigurationTypeName='MyClass'
}
Register-PSSessionConfiguration @sessionConfiguration

Um diese Konfiguration zu verwenden, geben Sie New-PSSession -ConfigurationName newshell.

Beispiel 2: Registrieren einer MaintenanceShell-Sitzungskonfiguration

In diesem Beispiel wird die MaintenanceShell-Sitzungskonfiguration auf dem lokalen Computer registriert. Der Parameter StartupScript gibt das Maintenance.ps1 Skript an.

Register-PSSessionConfiguration -Name MaintenanceShell -StartupScript C:\ps-test\Maintenance.ps1

Wenn ein Benutzer einen New-PSSession Befehl verwendet und die MaintenanceShell-Konfiguration auswählt, wird das Maintenance.ps1 Skript in der neuen Sitzung ausgeführt. Das Skript kann die Sitzung konfigurieren. Dazu gehören das Importieren von Modulen und das Festlegen der Ausführungsrichtlinie für die Sitzung. Wenn das Skript Fehler generiert, einschließlich nicht beendeter Fehler, schlägt der New-PSSession Befehl fehl.

Beispiel 3: Registrieren einer Sitzungskonfiguration

In diesem Beispiel wird die AdminShell-Sitzungskonfiguration registriert.

Die $sessionParams Variable ist eine Hashtabelle, die alle Parameterwerte enthält. Diese Hashtabelle wird mithilfe der PowerShell-Splatting an das Cmdlet übergeben. Der Register-PSSessionConfiguration Befehl verwendet den SecurityDescritorSDDL-Parameter , um die SDDL im Wert der $sddl Variablen und den Parameter MaximumReceivedObjectSizeMB anzugeben, um die Objektgröße zu erhöhen. Außerdem wird der StartupScript-Parameter verwendet, um ein Skript anzugeben, das die Sitzung konfiguriert.

$sddl = "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;FASA;GWGX;;;WD)"
$sessionParams = @{
    Name="AdminShell"
    SecurityDescriptorSDDL=$sddl
    MaximumReceivedObjectSizeMB=20
    StartupScript="C:\scripts\AdminShell.ps1"
}
Register-PSSessionConfiguration @sessionParams

Beispiel 4: Zurückgeben eines Konfigurationscontainerelements

In diesem Beispiel wird gezeigt, wie die MaintenanceShell-Konfiguration registriert wird. Register-PSSessionConfiguration gibt ein WSManConfigContainerElement -Objekt zurück, das in der $s Variablen gespeichert ist. Format-List zeigt alle Eigenschaften des zurückgegebenen Objekts an. Die PSPath-Eigenschaft zeigt, dass das Objekt in einem Verzeichnis des WSMan:-Laufwerks gespeichert ist. Get-ChildItem (Alias dir) zeigt die Elemente im WSMan:\LocalHost\PlugIn Pfad an. Dazu gehören die neue MaintenanceShell-Konfiguration und die beiden Standardkonfigurationen, die in PowerShell enthalten sind.

$s = Register-PSSessionConfiguration -Name MaintenanceShell -StartupScript C:\ps-test\Maintenance.ps1
$s | Format-List -Property *
dir WSMan:\LocalHost\Plugin

PSPath            : Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell
PSParentPath      : Microsoft.WSMan.Management\WSMan::localhost\Plugin
PSChildName       : MaintenanceShell
PSDrive           : WSMan
PSProvider        : Microsoft.WSMan.Management\WSMan
PSIsContainer     : True
Keys              : {Name=MaintenanceShell}
Name              : MaintenanceShell
TypeNameOfElement : Container

Name                      Type                 Keys
----                      ----                 ----
MaintenanceShell          Container            {Name=MaintenanceShell}
microsoft.powershell      Container            {Name=microsoft.powershell}
microsoft.powershell32    Container            {Name=microsoft.powershell32}

Beispiel 5: Registrieren einer Sitzungskonfiguration mit einem Startskript

In diesem Beispiel erstellen und registrieren wir die WithProfile-Sitzungskonfiguration . Der StartupScript-Parameter leitet PowerShell an, um das angegebene Skript für jede Sitzung auszuführen, die die Sitzungskonfiguration verwendet.

Register-PSSessionConfiguration -Name WithProfile -StartupScript Add-Profile.ps1

Das Skript enthält einen einzelnen Befehl, der dot sourcing verwendet, um das CurrentUserAllHosts-Profil des Benutzers im aktuellen Bereich der Sitzung auszuführen.

Weitere Informationen zu Profilen finden Sie unter about_Profiles. Weitere Informationen zur Dot Sourcing finden Sie unter about_Scopes.

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.
Lokal. Ermöglicht Benutzern des lokalen Computers die Verwendung der Sitzungskonfiguration zum Erstellen einer lokalen Loopbacksitzung auf demselben Computer, verweigert jedoch den Zugriff auf Remotebenutzer.
Remote. Ermöglicht lokalen und Remotebenutzern die Verwendung der Sitzungskonfiguration zum Erstellen von Sitzungen und Ausführen von Befehlen auf diesem Computer.

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 den Remotezugriff auf alle Sitzungskonfigurationen, das Enable-PSSessionConfiguration Cmdlet aktiviert Sitzungskonfigurationen, und das Disable-PSRemoting Cmdlet verhindert den Remotezugriff auf alle Sitzungskonfigurationen.

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. Verwenden Sie diesen Parameter, wenn der Wert des AssemblyName-Parameters keinen Pfad enthält. Der Standardwert ist das aktuelle Verzeichnis.

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

-AssemblyName

Gibt den Namen einer Assemblydatei (*.dll) an, in der der Konfigurationstyp definiert ist. Sie können den Pfad der .dll in diesem Parameter oder im Wert des ApplicationBase-Parameters angeben.

Dieser Parameter ist erforderlich, wenn Sie den ConfigurationTypeName-Parameter angeben.

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

-ConfigurationTypeName

Gibt den vollqualifizierten Namen des Microsoft .NET Framework-Typs an, der für diese Konfiguration verwendet wird. Der von Ihnen angegebene Typ muss die System.Management.Automation.Remoting.PSSessionConfiguration-Klasse implementieren.

Um die Assemblydatei (*.dll) anzugeben, die den Konfigurationstyp implementiert, geben Sie die Parameter "AssemblyName " und "ApplicationBase " an.

Durch das Erstellen eines Typs können Sie weitere Aspekte der Sitzungskonfiguration steuern, z. B. das Verfügbarmachen oder Ausblenden bestimmter Parameter von Cmdlets oder das Festlegen von Grenzwerten für Die Datengröße und Objektgröße, die Benutzer nicht außer Kraft setzen können.

Wenn Sie diesen Parameter weglassen, wird die DefaultRemotePowerShellConfiguration-Klasse für die Sitzungskonfiguration verwendet.

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 Neustartaufforderung zu unterdrücken, geben Sie den Parameter NoServiceRestart an.

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

-MaximumReceivedDataSizePerCommandMB

Gibt einen 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 MB.

Wenn ein Grenzwert für die Datengröße im Konfigurationstyp definiert ist, der im ConfigurationTypeName-Parameter angegeben ist, wird der Grenzwert im Konfigurationstyp verwendet, und 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 einen Grenzwert 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 MB.

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

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

-ModulesToImport

Gibt die Module an, die automatisch in Sitzungen importiert werden, die die Sitzungskonfiguration verwenden.

Standardmäßig wird nur Microsoft.PowerShell.Core in Sitzungen importiert. Sofern die Cmdlets nicht ausgeschlossen sind, können Import-Module Sie der Sitzung Module hinzufügen.

Die in diesem Parameterwert angegebenen Module werden zusätzlich zu Modulen importiert, die durch den SessionType-Parameter und die im ModulesToImport-Schlüssel in der Sitzungskonfigurationsdatei (New-PSSessionConfigurationFile) aufgeführt sind. Einstellungen in der Sitzungskonfigurationsdatei können jedoch die von Modulen exportierten Befehle ausblenden oder verhindern, dass Benutzer sie verwenden.

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 einen Namen für die Sitzungskonfiguration an. Dieser Parameter ist erforderlich.

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, den Dienst neu zu starten.

Wenn Sie einen Register-PSSessionConfiguration Befehl ausführen, 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.

Um den WinRM-Dienst ohne Aufforderung neu zu starten, geben Sie den Parameter Force an. Verwenden Sie das Restart-Service 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 und Dateinamen einer Sitzungskonfigurationsdatei (PSSC) an, z. B. einen, der von New-PSSessionConfigurationFile. Wenn Sie den Pfad weglassen, ist die Standardeinstellung das aktuelle Verzeichnis.

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

-ProcessorArchitecture

Bestimmt, ob eine 32-Bit- oder 64-Bit-Version des PowerShell-Prozesses in Sitzungen gestartet wird, die diese Sitzungskonfiguration verwenden. Die zulässigen Werte für diesen Parameter sind: x86 (32-Bit) und AMD64 (64-Bit). Der Standardwert wird von der Prozessorarchitektur des Computers bestimmt, der die Sitzungskonfiguration hostet.

Sie können diesen Parameter verwenden, um eine 32-Bit-Sitzung auf einem 64-Bit-Computer zu erstellen. Versuche zum Erstellen eines 64-Bit-Prozesses auf einem 32-Bit-Computer schlagen fehl.

Type:	String
Aliases:	PA
Accepted values:	x86, amd64
Position:	Named
Default value:	None
Required:	False
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 dem 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 Zeichenfolge für die Security Descriptor Definition Language (SDDL) der 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 über die Berechtigung "Ausführen" (Aufruf) für die Konfiguration verfügen.

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

Wenn Sie diesen Parameter weglassen, wird die Stamm-SDDL für den WinRM-Dienst für diese Konfiguration verwendet. Verwenden Sie zum Anzeigen oder Ändern der Stamm-SDDL den WSMan-Anbieter. Beispiel: Get-Item wsman:\localhost\service\rootSDDL. Geben Sie weitere Informationen zum WSMan-Anbieter ein Get-Help wsman.

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 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. 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 anzeigt, das Sie beim Erstellen der SDDL für die Sitzungskonfiguration unterstützt. Das Eigenschaftenblatt wird angezeigt, nachdem Sie den Register-PSSessionConfiguration Befehl eingegeben und dann den WinRM-Dienst neu gestartet haben.

Denken Sie beim Festlegen der Berechtigungen für die Konfiguration daran, dass Benutzer mindestens über die Berechtigung "Ausführen" (Aufruf) verfügen müssen, um 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 den vollqualifizierten Pfad eines PowerShell-Skripts an. Das angegebene Skript wird in der neuen Sitzung ausgeführt, die die Sitzungskonfiguration verwendet.

Sie können das Skript verwenden, um die Sitzung zusätzlich 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.

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

-ThreadApartmentState

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

Unbekannt
MTA
STA

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

-ThreadOptions

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

Standard
WiederverwendenThread
UseCurrentThread
UseNewThread

Der Standardwert ist UseCurrentThread.

Weitere Informationen finden Sie unter PSThreadOptions-Aufzählung.

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

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

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

Ausgaben

WSManConfigContainerElement

Hinweise

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

Zum Ausführen dieses Cmdlets müssen Sie PowerShell mithilfe der Option "Als Administrator ausführen" starten.

Dieses Cmdlet generiert XML, das eine WS-Management-Plug-In-Konfiguration (Web Services for Management) darstellt, und sendet den XML-Code an WS-Management, der das Plug-In auf dem lokalen Computer registriert (New-Item wsman:\localhost\plugin).

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.

Register-PSSessionConfiguration

Syntax

Beschreibung

Beispiele

Beispiel 1: Registrieren einer NewShell-Sitzungskonfiguration

Beispiel 2: Registrieren einer MaintenanceShell-Sitzungskonfiguration

Beispiel 3: Registrieren einer Sitzungskonfiguration

Beispiel 4: Zurückgeben eines Konfigurationscontainerelements

Beispiel 5: Registrieren einer Sitzungskonfiguration mit einem Startskript

Parameter

-AccessMode

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-ProcessorArchitecture

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Eingaben

Ausgaben

Hinweise

Feedback

Zusätzliche Ressourcen

Register-PSSessionConfiguration

Syntax

Beschreibung

Beispiele

Beispiel 1: Registrieren einer NewShell-Sitzungskonfiguration

Beispiel 2: Registrieren einer MaintenanceShell-Sitzungskonfiguration

Beispiel 3: Registrieren einer Sitzungskonfiguration

Beispiel 4: Zurückgeben eines Konfigurationscontainerelements

Beispiel 5: Registrieren einer Sitzungskonfiguration mit einem Startskript

Parameter

-AccessMode

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-ProcessorArchitecture

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Eingaben

Ausgaben

Hinweise

Ähnliche Themen

Feedback

Zusätzliche Ressourcen