Udostępnij za pośrednictwem

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

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie cmdlet Enable-PSSessionConfiguration umożliwia konfiguracje zarejestrowanych sesji, które zostały wyłączone, na przykład przy użyciu poleceń cmdlet Disable-PSSessionConfiguration lub Disable-PSRemoting albo parametru AccessMode 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ę Microsoft.PowerShell, która jest domyślną konfiguracją używaną na potrzeby sesji.

Enable-PSSessionConfiguration usuwa ustawienie Deny_All z deskryptora zabezpieczeń konfiguracji sesji, których 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 również ustawia wartość właściwości Enabled konfiguracji sesji (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) na true. Jednak Enable-PSSessionConfiguration nie usuwa ani nie zmienia ustawienia deskryptora zabezpieczeń Network_Deny_All (AccessMode=Local), które zezwala tylko użytkownikom komputera lokalnego na korzystanie z konfiguracji sesji.

Przykłady

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

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

Enable-PSSessionConfiguration

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

W tym przykładzie ponownie włączono konfiguracje sesji MaintenanceShell i AdminShell 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 MaintenanceShell konfiguracji sesji 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.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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, aby Enable-PSSessionConfiguration.

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

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-NoServiceRestart

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SecurityDescriptorSddl

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

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 kończy się niepowodzeniem w sieci publicznej.

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 polecenia cmdlet Set-NetFirewallRule w module NetSecurity. Aby uzyskać więcej informacji, zobacz Enable-PSRemoting.

Ten parametr został wprowadzony w programie PowerShell 3.0.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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

To polecenie cmdlet jest dostępne tylko na platformach windows.

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