Get-PSSessionConfiguration
Ruft die registrierten Sitzungskonfigurationen auf dem Computer ab.
Syntax
Get-PSSessionConfiguration [[-Name] <string[]>] [<CommonParameters>]
Beschreibung
Das Cmdlet "Get-PSSessionConfiguration" ruft die Sitzungskonfigurationen ab, die auf dem lokalen Computer registriert wurden. Dieses erweiterte Cmdlet wurde für Systemadministratoren entwickelt, die damit benutzerdefinierte Sitzungskonfigurationen für ihre Benutzer verwalten können.
Um eine Sitzungskonfiguration zu erstellen und zu registrieren, verwenden Sie das Cmdlet "Register-PSSessionConfiguration".
Parameter
-Name <string[]>
Ruft nur die Sitzungskonfigurationen mit den angegebenen Namen oder Namensmustern ab. Geben Sie einen oder mehrere Namen für Sitzungskonfigurationen ein. Platzhalter sind zulässig.
Erforderlich? |
false |
Position? |
1 |
Standardwert |
Alle Sitzungskonfigurationen auf dem lokalen Computer |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
true |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
Eingaben |
Keiner Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden. |
Ausgaben |
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration |
Hinweise
Sie müssen Windows PowerShell mit der Option "Als Administrator ausführen" öffnen, um dieses Cmdlet unter Windows Vista, Windows Server 2008 und höheren Versionen von Windows auszuführen.
Um die Sitzungskonfigurationen auf dem Computer anzuzeigen, müssen Sie Mitglied der Gruppe "Administratoren" auf dem Computer sein.
Um auf einem Remotecomputer einen Get-PSSessionConfiguration-Befehl auszuführen, muss die CredSSP (Credential Security Service Provider)-Authentifizierung in den Clienteinstellungen auf dem lokalen Computer (mit dem Cmdlet "Enable-WSManCredSSP") und in den Diensteinstellungen auf dem Remotecomputer aktiviert werden. Beim Einrichten der Remotesitzung müssen Sie außerdem den CredSSP-Wert des Authentication-Parameters verwenden. Andernfalls wird der Zugriff verweigert.
Beispiel 1
C:\PS>get-pssessionconfiguration
Beschreibung
-----------
Dieser Befehl ruft die Sitzungskonfigurationen auf dem Computer ab.
Beispiel 2
C:\PS>get-pssessionconfiguration -name Microsoft*
Name PSVersion StartupScript Permission
---- --------- ------------- ----------
microsoft.powershell 2.0 BUILTIN\Administrators AccessAll...
microsoft.powershell32 2.0 BUILTIN\Administrators AccessAll...
Beschreibung
-----------
Dieser Befehl verwendet den Name-Parameter von Get-PSSessionConfiguration, um nur die Sitzungskonfigurationen abzurufen, deren Namen mit "Microsoft" beginnen.
Mit diesem Befehl werden die beiden Standardsitzungskonfigurationen abgerufen, die mit Windows PowerShell ausgeliefert werden.
Beispiel 3
C:\PS>Get-PSSessionConfiguration -name microsoft.powershell | get-member
TypeName: Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
Capability NoteProperty System.Object[] Capability=System.Object[]
ExactMatch NoteProperty System.String ExactMatch=False
Filename NoteProperty System.String Filename=%windir%\system32\pwrshplugin.dll
lang NoteProperty System.String lang=en-US
Name NoteProperty System.String Name=microsoft.powershell
PSVersion NoteProperty System.String PSVersion=2.0
ResourceUri NoteProperty System.String ResourceUri=https://schemas.microsoft.com/powershell/microsoft.powershell
SDKVersion NoteProperty System.String SDKVersion=1
SecurityDescriptorSddl NoteProperty System.String SecurityDescriptorSddl=O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
SupportsOptions NoteProperty System.String SupportsOptions=true
Uri NoteProperty System.String Uri=https://schemas.microsoft.com/powershell/microsoft.powershell
xmlns NoteProperty System.String xmlns=https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
XmlRenderingType NoteProperty System.String XmlRenderingType=text
Permission ScriptProperty System.Object Permission {get=trap { continue; }...
C:\PS> Get-PSSessionConfiguration -name microsoft.powershell | format-list -property *
Name : microsoft.powershell
Filename : %windir%\system32\pwrshplugin.dll
SDKVersion : 1
XmlRenderingType : text
lang : en-US
PSVersion : 2.0
ResourceUri : https://schemas.microsoft.com/powershell/microsoft.powershell
SupportsOptions : true
Capability : {Shell}
Uri : https://schemas.microsoft.com/powershell/microsoft.powershell
SecurityDescriptorSddl : O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;SA;GXGW;;;WD)
ExactMatch : False
xmlns : https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Permission : BUILTIN\Administrators AccessAllowed
Beschreibung
-----------
Mit diesen Befehlen wird das PSSessionConfiguration-Objekt untersucht, das von Get-PSSessionConfiguration zurückgegeben wird.
Der erste Befehl verwendet das Cmdlet "Get-PSSessionConfiguration", um die Microsoft.PowerShell-Standardkonfiguration abzurufen.
Der zweite Befehl verwendet einen Pipelineoperator (|), um das von Get-PSSessionConfiguration zurückgegebene Objekt an das Cmdlet "Get-Member" zu senden. Die Ausgabe enthält die Eigenschaften und Methoden des Objekts.
Der dritte Befehl sendet das gleiche Objekt an das Cmdlet "Format-List". Der Property-Parameter mit dem Wert für alle (*) weist Format-List an, alle Eigenschaften und Eigenschaftenwerte des in einer Liste enthaltenen Objekts anzuzeigen.
Die Ausgabe dieses Befehls enthält sehr nützliche Informationen, einschließlich des Speicherorts der DLL, die den Konfigurationstyp implementiert, den Ressource Uniform Resource Identifier (URI) für den erstellten Endpunkt und die Security Descriptor Definition Language (SDDL) für die Konfiguration.
Beispiel 4
C:\PS>dir wsman:\localhost\plugin
WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin
Name Type Keys
---- ---- ----
Event Forwarding Plugin Container {Name=Event Forwarding Plugin}
MaintenanceShell Container {Name=MaintenanceShell}
microsoft.powershell Container {Name=microsoft.powershell}
microsoft.powershell32 Container {Name=microsoft.powershell32}
WMI Provider Container {Name=WMI Provider}
Beschreibung
-----------
Dieser Befehl verwendet das Cmdlet "Get-ChildItem" (alias = dir) im Anbieterlaufwerk "WSMan:", um den Inhalt des Knotens "Plugin" einzusehen.
Dies ist eine andere Methode, die Sitzungskonfigurationen auf dem Computer anzuzeigen.
Der PlugIn-Knoten enthält neben anderen Plug-Ins für die WS-Verwaltung ContainerElement-Objekte (Microsoft.WSMan.Management.WSManConfigContainerElement), die die registrierten Windows PowerShell-Sitzungskonfigurationen darstellen.
Beispiel 5
C:\PS>enable-wsmanCredSSP -delegate server02
C:\PS> connect-wsman server02
C:\PS> set-item wsman:\server02*\service\auth\credSSP -value $true
C:\PS> invoke-command -scriptblock {Get-PSSessionConfiguration} -computername Server02 -authentication CredSSP -credential Domain01\Admin01
Name PSVersion StartupScript Permission PSComputerName
---- --------- ------------- ---------- --------------
microsoft.powershell 2.0 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
microsoft.powershell32 2.0 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
MyX86Shell 2.0 c:\test\x86Shell.ps1 BUILTIN\Administrators AccessAll... server02.corp.fabrikam.com
Beschreibung
-----------
In diesem Beispiel wird gezeigt, wie ein Get-PSSessionConfiguration-Befehl auf einem Remotecomputer ausgeführt wird. Der Befehl erfordert, dass CredSSP-Delegierung in den Clienteinstellungen auf dem lokalen Computer und in den Diensteinstellungen auf dem Remotecomputer aktiviert wird. Um die Befehle in diesem Beispiel auszuführen, müssen Sie Mitglied der Gruppe "Administratoren" auf dem lokalen Computer und dem Remotecomputer sein.
Der erste Befehl verwendet das Cmdlet "Enable-WSManCredSSP", um die CredSSP-Delegierung vom lokalen Computer "Server01" an den Remotecomputer "Server02" zu aktivieren. Dadurch wird die CredSSP-Clienteinstellung auf dem lokalen Computer konfiguriert.
Der zweite Befehl verwendet das Cmdlet "Connect-WSMan", um eine Verbindung mit dem Computer "Server02" herzustellen. Durch diese Aktion wird dem Laufwerk "WSMan:" auf dem lokalen Computer ein Knoten für Computer "Server02" hinzugefügt. So können die Einstellungen für die WS-Verwaltung auf dem Computer "Server02" angezeigt und geändert werden.
Der dritte Befehl verwendet das Cmdlet "Set-Item", um den Wert des CredSSP-Elements im Service-Knoten von Computer "Server02" in "True" zu ändern. Dadurch werden die Diensteinstellungen auf dem Remotecomputer konfiguriert.
Der vierte Befehl verwendet das Cmdlet "Invoke-Command", um einen Get-PSSessionConfiguration-Befehl auf dem Computer "Server02" auszuführen. Dabei wird der Credential-Parameter und der Authentication-Parameter mit dem Wert "CredSSP" verwendet.
Beispiel 6
C:\PS>(get-PSSessionConfiguration -name CustomShell).resourceURI
https://schemas.microsoft.com/powershell/microsoft.CustomShell
Beschreibung
-----------
Dieser Befehl verwendet das Cmdlet "Get-PSSessionConfiguration", um den Ressourcen-URI einer Sitzungskonfiguration abzurufen.
Er ist hilfreich beim Festlegen des Werts der Einstellungsvariablen "$PSSessionConfigurationName", die einen Ressourcen-URI akzeptiert.
Die Variable "$PSSessionConfiguationName" gibt die Standardkonfiguration an, die beim Erstellen der Sitzung verwendet wird. Diese Variable wird auf dem lokalen Computer festgelegt, gibt jedoch eine Konfiguration auf dem Remotecomputer an. Weitere Informationen über die Variable "$PSSessionConfiguration" finden Sie unter "about_Preference_Variables".
Siehe auch
Konzepte
about_Session_Configurations
Disable-PSSessionConfiguration
Enable-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration
WSMan Provider