Register-PSSessionConfiguration

Register-PSSessionConfiguration [-AssemblyName] <string> [-ConfigurationTypeName] <string> [-ApplicationBase <string>] [-Name] <string> [-Force] [-MaximumReceivedDataSizePerCommandMB <double>] [-MaximumReceivedObjectSizeMB <double>] [-NoServiceRestart] [-ProcessorArchitecture <string>] [-SecurityDescriptorSDDL <string>] [-ShowSecurityDescriptorUI] [-StartupScript <string>] [-ThreadApartmentState {<STA> | <MTA> | <Unknown>}] [-ThreadOptions {<Default> | <UseNewThread> | <ReuseThread> | <UseCurrentThread>}] [-Bestätigung] [-WhatIf] [<CommonParameters>]

C:\PS>register-pssessionConfiguration -name NewShell -applicationBase c:\MyShells\ -assemblyName MyShell.dll -configurationTypeName MyClass

Beschreibung
-----------
Mit diesem Befehl wird die NewShell-Sitzungskonfiguration registriert. Er verwendet den ApplicationName-Parameter und den ApplicationBase-Parameter, um den Speicherort der Datei "MyShell.dll" anzugeben, die die Cmdlets und Anbieter in der Sitzungskonfiguration festlegt. Darüber hinaus verwendet er den ConfigurationTypeName-Parameter, um eine neue Klasse zur weiteren Konfiguration der Sitzung anzugeben.

Um diese Konfiguration zu verwenden, würden Benutzer "new-pssession -configurationname newshell" eingeben.

C:\PS>register-pssessionConfiguration -name MaintenanceShell -startupScript c:\ps-test\Maintenance.ps1

Beschreibung
-----------
Mit diesem Befehl wird die MaintenanceShell-Konfiguration auf dem lokalen Computer registriert. Der Befehl gibt das Skript "Maintenance.ps1" mithilfe des StartupScript-Parameters an.

Wenn ein Benutzer einen New-PSSession-Befehl verwendet und die MaintenanceShell-Konfiguration auswählt, wird das Skript "Maintenance.ps1" in der neuen Sitzung ausgeführt. Das Skript ist in der Lage, die Sitzung zu konfigurieren, z. B. Module zu importieren, Windows PowerShell-Snap-Ins hinzuzufügen und die Ausführungsrichtlinie für die Sitzung festzulegen. Wenn das Skript Fehler generiert, einschließlich Fehler ohne Abbruch, führt der New-PSSession-Befehl zu einem Fehler.

C:\PS>$sddl = "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;FA;SA;GWGX;;WD)"

C:\PS> register-pssessionconfiguration -name AdminShell -securityDescriptorSDDL $sddl -maximumReceivedObjectSizeMB 20 -startupScript c:\scripts\AdminShell.ps1

Beschreibung
-----------
In diesem Beispiel wird die AdminShell-Sitzungskonfiguration registriert. 

Der erste Befehl speichert eine benutzerdefinierte SDDL in der Variablen "$sddl". 

Mit dem zweiten Befehl wird die neue Shell registriert. Der Befehl gibt die SDDL im Wert der Variablen "$sddl" und den MaximumReceivedObjectSizeMB-Parameter zur Erweiterung der Objektgrößenbeschränkung mithilfe des SecurityDescritorSDDL-Parameters an. Darüber hinaus gibt er mithilfe des StartupScript-Parameters ein Skript an, das die Sitzung konfiguriert.

Als Alternative zum SecurityDescriptorSDDL-Parameter können Sie den ShowSecurityDescriptorUI-Parameter verwenden, der ein Eigenschaftenblatt anzeigt, mit dem Sie Berechtigungen für die Sitzungskonfiguration festlegen können. Wenn Sie im Eigenschaftenblatt auf "OK" klicken, generiert das Tool eine SDDL für die Sitzungskonfiguration.

C:\PS>$s = register-pssessionConfiguration -name MaintenanceShell -startupScript c:\ps-test\Maintenance.ps1

C:\PS> $s

   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin

Name                      Type                 Keys
----                      ----                 ----
MaintenanceShell          Container            {Name=MaintenanceShell}


C:\PS> $s.getType().fullname
TypeName: Microsoft.WSMan.Management.WSManConfigContainerElement


C:\PS> $s | format-list -property *

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


C:\PS> dir wsman:\localhost\plugin

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

Beschreibung
-----------
Dieses Beispiel zeigt, dass ein Register-PSSessionConfiguration-Befehl ein WSManConfigContainerElement zurückgibt. Es veranschaulicht außerdem, wie Sie die Containerelemente im Laufwerk "WSMan:" finden.

Der erste Befehl verwendet das Cmdlet "Register-PSSessionConfiguration", um die MaintenanceShell-Konfiguration zu registrieren. Das vom Cmdlet zurückgegebene Objekt wird in der Variablen "$j" gespeichert.

Der zweite Befehl zeigt den Inhalt der Variablen "$s" an. 

Der dritte Befehl zeigt den Typnamen des Objekts, das von Register-PSSessionConfiguration zurückgegeben wird, mithilfe der GetType-Methode und ihrer FullName-Eigenschaft an.

Der vierte Befehl verwendet das Cmdlet "Format-List", um alle Eigenschaften des Objekts anzuzeigen, die von Register-PSSessionConfiguration in einer Liste zurückgegeben werden. Die PSPath-Eigenschaft zeigt, dass das Objekt in einem Verzeichnis des Laufwerks "WSMan:" gespeichert wird.

Der fünfte Befehl verwendet das Cmdlet "Get-ChildItem", um die Elemente im Pfad "WSMan:\LocalHost\PlugIn" anzuzeigen. Diese schließen die neue MaintenanceShell-Konfiguration und die beiden Standardkonfigurationen ein, die mit Windows PowerShell ausgeliefert werden.

C:\PS>register-pssessionconfiguration -name WithProfile -startupScript add-profile.ps1

# Add-Profile.ps1

. c:\users\admin01\documents\windowspowershell\profile.ps1

Beschreibung
-----------
Mit diesem Befehl wird die WithProfile-Sitzungskonfiguration erstellt und auf dem lokalen Computer registriert. Der Befehl weist Windows PowerShell mit dem StartupScript-Parameter an, das angegebene Skript in einer beliebigen Sitzung auszuführen, die die Sitzungskonfiguration verwendet.

Der Inhalt des angegebenen Skripts "Add-Profile.ps1" wird ebenfalls angezeigt. Das Skript enthält einen einzelnen Befehl, der die DOT-Quellentnahme verwendet, um das CurrentUserAllHosts-Profil des Benutzers im aktuellen Bereich der Sitzung auszuführen.

Weitere Informationen über Profile finden Sie unter "about_Profiles". Weitere Informationen zur DOT-Quellentnahme finden Sie unter "about_Scopes".