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, die auch als Endpunkt bezeichnet wird. 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 in der aktuellen Sitzung erstellte Remotesitzungen angibt.

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 zur Verwendung 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 ein New-PSSession -ConfigurationName newshell.

Beispiel 2: Registrieren einer MaintenanceShell-Sitzungskonfiguration

In diesem Beispiel wird die MaintenanceShell-Sitzungskonfiguration auf dem lokalen Computer registriert. Der StartupScript-Parameter 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 Konfiguration der AdminShell-Sitzung 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 den Grenzwert für die Objektgröße zu erhöhen. Darüber hinaus verwendet er den StartupScript-Parameter, um ein Skript für die Sitzungskonfiguration anzugeben.

$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-PSSessionConfigurationgibt ein in der $s Variablen gespeichertes WSManConfigContainerElement-Objekt zurück. Format-List zeigt alle Eigenschaften des zurückgegebenen Objekts an. Die PSPath-Eigenschaft zeigt, dass das Objekt in einem Verzeichnis auf dem WSMan:-Laufwerk 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 weist PowerShell an, 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-Quellentnahme 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-Quellentnahme 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 Sitzungskonfiguration zum Erstellen einer lokalen Loopbacksitzung auf demselben Computer zu verwenden, verweigert jedoch Remotebenutzern den Zugriff.
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 überschreiben. Beispielsweise ermöglicht das Enable-PSRemoting Cmdlet den Remotezugriff auf alle Sitzungskonfigurationen, das Enable-PSSessionConfiguration Cmdlet aktiviert Sitzungskonfigurationen, und das Cmdlet verhindert den Disable-PSRemoting 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 des .dll in diesem Parameter oder im Wert des ApplicationBase-Parameters angeben.

Dieser Parameter ist erforderlich, wenn Sie den Parameter ConfigurationTypeName 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 Typ, den Sie angeben, muss die System.Management.Automation.Remoting.PSSessionConfigurationKlasse 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 Größe von Daten und Objekten, 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.

Geben Sie den Parameter NoServiceRestart an, um einen Neustart zu verhindern und die Neustartaufforderung zu unterdrücken.

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 einem einzelnen Remotebefehl an diesen Computer gesendet werden kann. Geben Sie die Datengröße in Megabyte (MB) ein. Der Standardwert ist 50 MB.

Wenn eine Datengrößenbeschränkung im Konfigurationstyp definiert ist, der im ConfigurationTypeName-Parameter angegeben ist, wird die Beschränkung im Konfigurationstyp verwendet und der Wert dieses Parameters 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 einem einzelnen Objekt an diesen Computer gesendet werden kann. Geben Sie die Datengröße in Megabyte ein. Der Standardwert ist 10 MB.

Wenn eine Objektgrößenbeschränkung im Konfigurationstyp definiert ist, der im ConfigurationTypeName-Parameter angegeben ist, wird die Beschränkung im Konfigurationstyp verwendet und der Wert dieses Parameters 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 Sie verwenden Import-Module , um der Sitzung Module hinzuzufügen.

Die in diesem Parameterwert angegebenen Module werden in Ergänzungen zu Modulen importiert, die durch den Parameter SessionType angegeben werden, und zu den Modulen, die in der Sitzungskonfigurationsdatei (New-PSSessionConfigurationFile) im Schlüssel ModulesToImport 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 zum Neustarten des Diensts.

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.

Geben Sie den Force-Parameter an, 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 und Dateinamen einer Sitzungskonfigurationsdatei (PSSC) an, z. B. eine von erstellt.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 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 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 verwenden zu können, müssen Benutzer mindestens über die Berechtigung Ausführen (Invoke) für die Konfiguration verfügen.

Wenn die Sicherheitsbeschreibung komplex ist, sollten Sie den ShowSecurityDescriptorUI-Parameter anstelle dieses Parameters 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. Um weitere Informationen zum WSMan-Anbieter zu erfahren, geben Sie 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 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 anzeigt, mit dem Sie die SDDL für die Sitzungskonfiguration erstellen können. Das Eigenschaftenblatt wird angezeigt, nachdem Sie den Register-PSSessionConfiguration Befehl eingegeben und dann den WinRM-Dienst neu gestartet haben.

Beachten Sie beim Festlegen der Berechtigungen für die Konfiguration, 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 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, 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 den Apartmentstatus 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
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 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 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

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 Plug-In-Konfiguration für Webdienste für die Verwaltung (WS-Management) darstellt, und sendet die XML an WS-Management, die 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.

Freigeben über

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

Zusätzliche Ressourcen

Freigeben über

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

Zusätzliche Ressourcen