Enable-PSSessionConfiguration
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 Enable-PSSessionConfiguration
Cmdlet aktiviert registrierte Sitzungskonfigurationen, die deaktiviert wurden, z. B. mithilfe der Disable-PSSessionConfiguration
Cmdlets oder Disable-PSRemoting
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 , bei der es sich um die Standardkonfiguration handelt, die für Sitzungen verwendet wird.
Enable-PSSessionConfiguration
entfernt die einstellung Deny_All aus dem Sicherheitsdeskriptor der betroffenen Sitzungskonfigurationen, aktiviert den Listener, der Anforderungen für beliebige IP-Adressen akzeptiert, und startet den WinRM-Dienst neu. Ab PowerShell 3.0 Enable-PSSessionConfiguration
wird auch der Wert der Enabled-Eigenschaft der Sitzungskonfiguration (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled
) auf True festgelegt. Enable-PSSessionConfiguration
Entfernt oder ändert jedoch nicht die Sicherheitsbeschreibungseinstellung Network_Deny_All (AccessMode=Local
), 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 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
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 der Dienst vom Cmdlet nicht neu gestartet wird.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecurityDescriptorSddl
Gibt einen Sicherheitsdeskriptor an, mit dem dieses Cmdlet den Sicherheitsdeskriptor in der Sitzungskonfiguration ersetzt.
Wenn Sie diesen Parameter weglassen, Enable-PSSessionConfiguration
löscht nur das Element alle verweigern aus dem Sicherheitsdeskriptor.
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. Standardmäßig Enable-PSSessionConfiguration
tritt in einem öffentlichen Netzwerk 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 zu aktivieren. 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 an dieses Cmdlet übergeben.
Sie können eine Zeichenfolge, die den Namen einer Sitzungskonfiguration enthält, an dieses Cmdlet übergeben.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Hinweise
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
Um dieses Cmdlet verwenden zu können, müssen Sie PowerShell mit der Option Als Administrator ausführen starten.
Ähnliche Themen
- Disable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WS-Management-Anbieter
- about_Session_Configurations
- about_Session_Configuration_Files