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, 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 registriert ist, wenn Sie PowerShell-Remoting aktivieren. 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 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 von 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 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 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. 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;FA;SA;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 Sie die MaintenanceShell-Konfiguration registrieren. 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 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 mit 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-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 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
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
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
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 Anzeigen oder Ausblenden bestimmter Parameter von Cmdlets oder Festlegen von Grenzwerten für die Größ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
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
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
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
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 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
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 vom SessionType-Parameter angegeben werden 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
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
Accept pipeline input:True
Accept wildcard characters:False

-NoServiceRestart

Startet den WinRM-Dienst nicht neu und unterdrückt die Eingabeaufforderung, um den Dienst neu zu starten.

Wenn Sie einen Register-PSSessionConfiguration Befehl ausführen, werden Sie standardmäßig aufgefordert, den WinRM-Dienst neu zu starten, um die neue Sitzungskonfiguration wirksam zu machen. 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 Force-Parameter an. Verwenden Sie das Restart-Service Cmdlet, um den WinRM-Dienst manuell neu zu starten.

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

-Path

Gibt den Pfad und dateinamen einer Sitzungskonfigurationsdatei (PSSC) an, z. B. einen 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
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
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
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
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 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. Geben Sie weitere Informationen zum WSMan-Anbieter ein Get-Help wsman.

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

-SessionTypeOption

Gibt typspezifische Optionen für die Sitzungskonfiguration an. Geben Sie ein Sitzungstypoptionenobjekt ein, z. B. das PSWorkflowExecutionOption -Objekt, das das New-PSWorkflowExecutionOption Cmdlet zurückgibt.

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
Accept pipeline input:False
Accept wildcard characters:False

-ShowSecurityDescriptorUI

Gibt an, dass dieses Cmdlet ein Eigenschaftenblatt anzeigt, das Ihnen beim Erstellen der SDDL für die Sitzungskonfiguration hilft. Das Eigenschaftenblatt wird angezeigt, nachdem Sie den Register-PSSessionConfiguration Befehl eingegeben haben und dann den WinRM-Dienst neu starten.

Beachten Sie beim Festlegen der Berechtigungen für die Konfiguration, dass Benutzer mindestens über die Berechtigung "Ausführen" (Aufrufen) 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
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, wird auch ein nicht beendeter Fehler generiert, wird die Sitzung nicht erstellt, und der New-PSSession Befehl schlägt fehl.

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

-ThreadApartmentState

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

  • Unbekannt
  • MTA
  • STA
Type:ApartmentState
Position:Named
Default value:None
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-Enumeration.

Type:PSThreadOptions
Accepted values:Default, UseNewThread, ReuseThread, UseCurrentThread
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-UseSharedProcess

Verwenden Sie nur einen Prozess, um alle Sitzungen zu hosten, die vomselben Benutzer gestartet werden und dieselbe 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
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
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Eingaben können nicht an dieses Cmdlet weitergereicht werden.

Ausgaben

Microsoft.WSMan.Management.WSManConfigContainerElement

Hinweise

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

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

Dieses Cmdlet generiert XML, das eine Web Services for Management (WS-Management)-Plug-In-Konfiguration darstellt und den XML-Code an WS-Management sendet, 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.