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

Das Enable-PSSessionConfiguration Cmdlet aktiviert registrierte Sitzungskonfigurationen, die deaktiviert wurden, z. B. mithilfe der Disable-PSSessionConfiguration Cmdlets oder Disable-PSRemoting oder des AccessMode-Parameters von Register-PSSessionConfiguration. Dies ist ein erweitertes Cmdlet für Systemadministratoren, die benutzerdefinierte Sitzungskonfigurationen für ihre Benutzer verwalten.

Ohne Parameter Enable-PSSessionConfiguration aktiviert die Microsoft.PowerShell-Konfiguration , die die Standardkonfiguration ist, die für Sitzungen verwendet wird.

Enable-PSSessionConfiguration entfernt die Einstellung Deny_All aus der Sicherheitsbeschreibung der betroffenen Sitzungskonfigurationen, aktiviert den Listener, der Anforderungen für eine beliebige IP-Adresse akzeptiert, und startet den WinRM-Dienst neu. Ab PowerShell 3.0 Enable-PSSessionConfiguration legt auch den Wert der Enabled-Eigenschaft der Sitzungskonfiguration (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) auf True fest. Entfernt oder ändert jedoch nicht die Network_Deny_All (AccessMode=Local)-Sicherheitsdeskriptoreinstellung, Enable-PSSessionConfiguration die nur Benutzern des lokalen Computers die Verwendung für die Sitzungskonfiguration zulässt.

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 beides 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 einer neuen Sicherheitsbeschreibung

In diesem Beispiel wird die MaintenanceShell-Sitzungskonfiguration erneut aktiviert und eine neue Sicherheitsbeschreibung 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

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Sie können auch eine Zeichenfolge, die einen Konfigurationsnamen oder ein Sitzungskonfigurationsobjekt enthält, an übergeben Enable-PSSessionConfiguration.

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecurityDescriptorSddl

Gibt einen Sicherheitsdeskriptor an, durch den dieses Cmdlet den Sicherheitsdeskriptor für die Sitzungskonfiguration ersetzt.

Wenn Sie diesen Parameter weglassen, Enable-PSSessionConfiguration löscht nur das Element Alle verweigern aus der Sicherheitsbeschreibung.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipNetworkProfileCheck

Gibt an, dass dieses Cmdlet die Sitzungskonfiguration aktiviert, wenn sich der Computer in einem öffentlichen Netzwerk befindet. Dieser Parameter aktiviert eine Firewallregel für öffentliche Netzwerke, die den Remotezugriff nur von Computern im selben lokalen Subnetz zulässt. In einem öffentlichen Netzwerk tritt standardmäßig Enable-PSSessionConfiguration ein Fehler auf.

Dieser Parameter ist für Clientversionen des Windows-Betriebssystems konzipiert. Serverversionen des Windows-Betriebssystems verfügen über eine Firewallregel für das lokale Subnetz für öffentliche Netzwerke. Wenn die Firewallregel des lokalen Subnetzes jedoch auf einer Serverversion des Windows-Betriebssystems deaktiviert ist, wird sie mit diesem Parameter erneut aktiviert.

Verwenden Sie das Cmdlet im NetSecurity-Modul, um die Einschränkung des lokalen Subnetzes zu entfernen und den Set-NetFirewallRule Remotezugriff von allen Standorten in öffentlichen Netzwerken aus zu ermöglichen. Weitere Informationen finden Sie unter Enable-PSRemoting.

Dieser Parameter wurde in PowerShell 3.0 eingeführt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Sie können ein Sitzungskonfigurationsobjekt oder eine Zeichenfolge, die den Namen einer Sitzungskonfiguration enthält, an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Objekte zurück.

Hinweise

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