Enable-PSSessionConfiguration

  • Odwołanie
Moduł:
Microsoft.PowerShell.Core

Włącza konfiguracje sesji na komputerze lokalnym.

Składnia

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

Opis

Polecenie Enable-PSSessionConfiguration cmdlet umożliwia konfiguracje sesji zarejestrowanej, które zostały wyłączone, takie jak za pomocą Disable-PSSessionConfiguration poleceń cmdlet lub Disable-PSRemoting lub parametr AccessMode polecenia Register-PSSessionConfiguration. Jest to zaawansowane polecenie cmdlet przeznaczone do użycia przez administratorów systemu w celu zarządzania niestandardowymi konfiguracjami sesji dla użytkowników.

Bez parametrów Enable-PSSessionConfiguration włącza konfigurację programu Microsoft.PowerShell , która jest domyślną konfiguracją używaną na potrzeby sesji.

Enable-PSSessionConfigurationUsuwa ustawienie Deny_All z deskryptora zabezpieczeń konfiguracji sesji, której dotyczy problem, włącza odbiornik, który akceptuje żądania na dowolnym adresie IP i uruchamia ponownie usługę WinRM. Począwszy od programu PowerShell 3.0, Enable-PSSessionConfiguration ustawia również wartość właściwości Enabled konfiguracji sesji (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) na True. Enable-PSSessionConfiguration Jednak nie usuwa ani nie zmienia ustawienia deskryptora zabezpieczeń Network_Deny_All (AccessMode=Local), które umożliwia tylko użytkownikom komputera lokalnego używanie do konfiguracji sesji.

Przykłady

Przykład 1. Ponowne włączanie sesji domyślnej

W tym przykładzie ponownie włącza konfigurację sesji domyślnej programu Microsoft.PowerShell na komputerze.

Enable-PSSessionConfiguration

Przykład 2. Ponowne włączanie określonych sesji

W tym przykładzie ponownie włączono konfiguracje sesji programu MaintenanceShell i programu Administracja Shell na komputerze.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

Przykład 3. Ponowne włączanie wszystkich sesji

W tym przykładzie ponownie włączono wszystkie konfiguracje sesji na komputerze. Te polecenia są równoważne. W związku z tym można użyć dowolnego z nich.

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

Enable-PSSessionConfiguration nie generuje błędu, jeśli włączono już konfigurację sesji.

Przykład 4. Ponowne włączanie sesji i określanie nowego deskryptora zabezpieczeń

W tym przykładzie ponownie włącza konfigurację sesji programu MaintenanceShell i określa nowy deskryptor zabezpieczeń dla konfiguracji.

$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

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Force

Wskazuje, że polecenie cmdlet nie wyświetla monitu o potwierdzenie i uruchamia ponownie usługę WinRM bez monitowania. Ponowne uruchomienie usługi powoduje, że zmiana konfiguracji jest skuteczna.

Aby zapobiec ponownemu uruchomieniu i pominąć monit o ponowne uruchomienie, użyj parametru NoServiceRestart .

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

-Name

Określa nazwy konfiguracji sesji do włączenia. Wprowadź co najmniej jedną nazwę konfiguracji. Dozwolone są symbole wieloznaczne.

Możesz również przekazać ciąg zawierający nazwę konfiguracji lub obiekt konfiguracji sesji do Enable-PSSessionConfiguration.

Jeśli pominiesz ten parametr, Enable-PSSessionConfiguration włączy konfigurację sesji Microsoft.PowerShell .

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

-NoServiceRestart

Wskazuje, że polecenie cmdlet nie uruchamia ponownie usługi.

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

-SecurityDescriptorSddl

Określa deskryptor zabezpieczeń, za pomocą którego to polecenie cmdlet zastępuje deskryptor zabezpieczeń w konfiguracji sesji.

Jeśli ten parametr zostanie pominięty, Enable-PSSessionConfiguration usunie tylko odmów wszystkich elementów z deskryptora zabezpieczeń.

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

-SkipNetworkProfileCheck

Wskazuje, że to polecenie cmdlet włącza konfigurację sesji, gdy komputer znajduje się w sieci publicznej. Ten parametr umożliwia regułę zapory dla sieci publicznych, która zezwala na dostęp zdalny tylko z komputerów w tej samej podsieci lokalnej. Domyślnie Enable-PSSessionConfiguration w sieci publicznej kończy się niepowodzeniem.

Ten parametr jest przeznaczony dla wersji klienta systemu operacyjnego Windows. Wersje serwera systemu operacyjnego Windows mają regułę zapory podsieci lokalnej dla sieci publicznych. Jeśli jednak reguła zapory podsieci lokalnej jest wyłączona w wersji serwera systemu operacyjnego Windows, ten parametr ponownie ją włączy.

Aby usunąć ograniczenie podsieci lokalnej i włączyć dostęp zdalny ze wszystkich lokalizacji w sieciach publicznych, użyj Set-NetFirewallRule polecenia cmdlet w module NetSecurity. Aby uzyskać więcej informacji, zobacz Enable-PSRemoting.

Ten parametr został wprowadzony w programie PowerShell 3.0.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

Do tego polecenia cmdlet można przekazać obiekt konfiguracji sesji.

String

Możesz potokować ciąg zawierający nazwę konfiguracji sesji do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

Aby użyć tego polecenia cmdlet, należy uruchomić program PowerShell przy użyciu opcji Uruchom jako administrator .