Register-PSSessionConfiguration
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-PSSessionConfiguration
gibt 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
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.