Aktiviert die Sitzungskonfigurationen auf dem lokalen Computer.
Syntax
Enable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-SecurityDescriptorSDDL <string>] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Das Cmdlet "Enable-PSSessionConfiguration" aktiviert registrierte Sitzungskonfigurationen, die mit dem Cmdlet "Disable-PSSessionConfiguration" deaktiviert wurden, erneut. Dieses erweiterte Cmdlet wurde für Systemadministratoren entwickelt, die damit benutzerdefinierte Sitzungskonfigurationen für ihre Benutzer verwalten können.
Ohne Parameter wird die Microsoft.PowerShell-Konfiguration, die die Standardkonfiguration für Sitzungen ist, von Enable-PSSessionConfiguration erneut aktiviert.
Dieses Cmdlet führt die folgenden Vorgänge für jede aktivierte Konfiguration aus:
– Entfernt die Einstellung "Alle verweigern" aus der Sicherheitsbeschreibung der Konfiguration oder ersetzt die Sicherheitsbeschreibung durch eine angegebene Beschreibung.
– Aktiviert den Listener, der Anforderungen an jede IP-Adresse akzeptiert.
– Startet den WinRM-Dienst neu.
Das Cmdlet "Enable-PSSessionConfiguration" ruft das Cmdlet "Set-WSManQuickConfig" auf. Es sollte jedoch nicht verwendet werden, um Remoting auf dem Computer zu aktivieren. Verwenden Sie stattdessen das umfassendere Cmdlet "Enable-PSRemoting".
Parameter
-Force
Unterdrückt alle Benutzeraufforderungen und startet den WinRM-Dienst ohne Aufforderung neu. Durch erneutes Starten des Diensts wird die Konfigurationsänderung wirksam.
Verwenden Sie den NoServiceRestart-Parameter, um einen Neustart zu verhindern und die Aufforderung zum Neustart zu unterdrücken.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Name <string[]>
Gibt die Namen der zu aktivierenden Sitzungskonfigurationen an. Geben Sie einen oder mehrere Konfigurationsnamen ein. Platzhalter sind zulässig.
Sie können auch über die Pipeline eine Zeichenfolge, die einen Konfigurationsnamen oder ein Sitzungskonfigurationsobjekt enthält, an Enable-PSSessionConfiguration übergeben.
Wenn Sie diesen Parameter nicht angeben, aktiviert Enable-PSSessionConfiguration die Microsoft.PowerShell-Sitzungskonfiguration.
|
Erforderlich? |
false |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue, ByPropertyName) |
|
Platzhalterzeichen akzeptieren? |
true |
-SecurityDescriptorSDDL <string>
Ersetzt die Sicherheitsbeschreibung für die Sitzungskonfiguration durch die angegebene Sicherheitsbeschreibung.
Wenn Sie diesen Parameter nicht angeben, löscht Enable-PSSessionConfiguration nur das Element "Alle verweigern" aus der Sicherheitsbeschreibung.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<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 |
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration, System.String Sie können über die Pipeline ein Sitzungskonfigurationsobjekt oder eine Zeichenfolge, die den Namen einer Sitzungskonfiguration enthält, an Enable-PSSessionConfiguration übergeben. |
|
Ausgaben |
None Dieses Cmdlet gibt keine Objekte zurück. |
Hinweise
Sie müssen Windows PowerShell mit der Option "Als Administrator ausführen" starten, um dieses Cmdlet unter Windows Vista, Windows Server 2008 und höheren Versionen von Windows auszuführen.
Beispiel 1
C:\PS>Enable-PSSessionConfiguration Beschreibung ----------- Mit diesem Befehl wird die standardmäßige Microsoft.PowerShell-Sitzungskonfiguration auf dem Computer erneut aktiviert.
Beispiel 2
C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell, AdminShell Beschreibung ----------- Mit diesem Befehl wird die MaintenanceShell-Sitzungskonfiguration und die AdminShell-Sitzungskonfiguration auf dem Computer erneut aktiviert.
Beispiel 3
C:\PS>Enable-PSSessionConfiguration -name * C:\PS> Get-PSSessionConfiguration | Enable-PSSessionConfiguration Beschreibung ----------- Mit diesen Befehlen werden alle Sitzungskonfigurationen auf dem Computer erneut aktiviert. Die Befehle sind äquivalent und können beide verwendet werden. Enable-PSSessionConfiguration generiert keinen Fehler, wenn Sie eine bereits aktivierte Sitzungskonfiguration aktivieren.
Beispiel 4
C:\PS>Enable-PSSessionConfiguration -name MaintenanceShell -securityDescriptorSDDL "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P" Beschreibung ----------- Dieser Befehl aktiviert die MaintenanceShell-Sitzungskonfiguration erneut und gibt eine neue Sicherheitsbeschreibung für die Konfiguration an.
Siehe auch