Enable-PSSessionConfiguration

Aktiviert die Sitzungskonfigurationen auf dem lokalen Computer.

Syntax

Enable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-SecurityDescriptorSDDL <string>] [-Confirm] [-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

-Confirm

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	Keiner 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

Konzepte

about_Session_Configurations
Disable-PSSessionConfiguration
Get-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration
WSMan Provider