Freigeben über

Enable-PSSessionConfiguration

  • Referenz
Modul:
Microsoft.PowerShell.Core

Aktiviert die Sitzungskonfigurationen auf dem lokalen Computer.

Syntax

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das cmdlet Enable-PSSessionConfiguration ermöglicht registrierte Sitzungskonfigurationen, die deaktiviert wurden, z. B. mithilfe der cmdlets Disable-PSSessionConfiguration oder Disable-PSRemoting Cmdlets oder des AccessMode--Parameters von Register-PSSessionConfiguration. Dies ist ein erweitertes Cmdlet, das von Systemadministratoren zum Verwalten angepasster Sitzungskonfigurationen für ihre Benutzer verwendet werden soll.

Ohne Parameter ermöglicht Enable-PSSessionConfiguration die Microsoft.PowerShell--Konfiguration, bei der es sich um die Standardkonfiguration handelt, die für Sitzungen verwendet wird.

Enable-PSSessionConfiguration entfernt die einstellung Deny_All aus der Sicherheitsbeschreibung der betroffenen Sitzungskonfigurationen, aktiviert den Listener, der Anforderungen an eine beliebige IP-Adresse akzeptiert, und startet den WinRM-Dienst neu. Ab PowerShell 3.0 legt Enable-PSSessionConfiguration auch den Wert der eigenschaft Enabled der Sitzungskonfiguration (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) auf "True" fest. Enable-PSSessionConfiguration entfernt oder ändert jedoch nicht die Network_Deny_All (AccessMode=Local) Sicherheitsbeschreibungseinstellung, mit der nur Benutzer des lokalen Computers die Sitzungskonfiguration verwenden können.

Beispiele

Beispiel 1: Erneutes Aktivieren der Standardsitzung

In diesem Beispiel wird die Microsoft.PowerShell Standardsitzungskonfiguration auf dem Computer erneut aktiviert.

Enable-PSSessionConfiguration

Beispiel 2: Erneutes Aktivieren der angegebenen Sitzungen

In diesem Beispiel werden die MaintenanceShell und AdminShell Sitzungskonfigurationen auf dem Computer erneut aktiviert.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

Beispiel 3: Erneutes Aktivieren aller Sitzungen

In diesem Beispiel werden alle Sitzungskonfigurationen auf dem Computer erneut aktiviert. Diese Befehle sind gleichwertig. Daher können Sie beide verwenden.

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

Enable-PSSessionConfiguration generiert keinen Fehler, wenn Sie eine bereits aktivierte Sitzungskonfiguration aktivieren.

Beispiel 4: Erneutes Aktivieren einer Sitzung und Angeben eines neuen Sicherheitsdeskriptors

In diesem Beispiel wird die MaintenanceShell Sitzungskonfiguration erneut aktiviert und ein neuer Sicherheitsdeskriptor für die Konfiguration angegeben.

$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Gibt an, dass das Cmdlet Sie nicht zur Bestätigung auffordert und den WinRM-Dienst ohne Aufforderung neu startet. Durch den Neustart des Diensts wird die Konfigurationsänderung wirksam.

Um einen Neustart zu verhindern und die Neustartaufforderung zu unterdrücken, verwenden Sie den Parameter NoServiceRestart.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt die Namen der zu aktivierenden Sitzungskonfigurationen an. Geben Sie einen oder mehrere Konfigurationsnamen ein. Wildcardzeichen sind zulässig.

Sie können auch eine Zeichenfolge mit einem Konfigurationsnamen oder einem Sitzungskonfigurationsobjekt an Enable-PSSessionConfigurationübergeben.

Wenn Sie diesen Parameter weglassen, aktiviert Enable-PSSessionConfiguration die Microsoft.PowerShell Sitzungskonfiguration.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-NoServiceRestart

Gibt an, dass das Cmdlet den Dienst nicht neu startet.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SecurityDescriptorSddl

Gibt einen Sicherheitsdeskriptor an, mit dem dieses Cmdlet den Sicherheitsdeskriptor in der Sitzungskonfiguration ersetzt.

Wenn Sie diesen Parameter weglassen, löscht Enable-PSSessionConfiguration nur das Verweigern aller Elemente aus der Sicherheitsbeschreibung.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipNetworkProfileCheck

Gibt an, dass dieses Cmdlet die Sitzungskonfiguration aktiviert, wenn sich der Computer in einem öffentlichen Netzwerk befindet. Dieser Parameter ermöglicht eine Firewallregel für öffentliche Netzwerke, die den Remotezugriff nur von Computern im selben lokalen Subnetz zulässt. Standardmäßig schlägt Enable-PSSessionConfiguration in einem öffentlichen Netzwerk fehl.

Dieser Parameter wurde für Clientversionen des Windows-Betriebssystems entwickelt. Serverversionen des Windows-Betriebssystems verfügen über eine lokale Subnetzfirewallregel für öffentliche Netzwerke. Wenn die lokale Subnetzfirewallregel jedoch auf einer Serverversion des Windows-Betriebssystems deaktiviert ist, wird dieser Parameter erneut aktiviert.

Um die lokale Subnetzeinschränkung zu entfernen und den Remotezugriff von allen Standorten in öffentlichen Netzwerken zu aktivieren, verwenden Sie das cmdlet Set-NetFirewallRule im NetSecurity-Modul. Weitere Informationen finden Sie unter Enable-PSRemoting.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Sie können ein Sitzungskonfigurationsobjekt an dieses Cmdlet weiterleiten.

String

Sie können eine Zeichenfolge mit dem Namen einer Sitzungskonfiguration an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

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

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