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 Enable-PSSessionConfiguration cmdlet włącza konfiguracje sesji zarejestrowanej, które zostały wyłączone, na przykład przy użyciu Disable-PSSessionConfiguration poleceń cmdlet lub Disable-PSRemoting lub parametru 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-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 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 AdminShell na komputerze.

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

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

Ten przykład ponownie włącza 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łączysz konfigurację sesji, która jest już włączona.

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 będzie 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żna również potokować ciąg zawierający nazwę konfiguracji lub obiekt konfiguracji sesji do Enable-PSSessionConfiguration.

Jeśli ten parametr zostanie pominięty, 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ń, z którym 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 systemu operacyjnego Windows mają lokalną regułę zapory podsieci 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łącza.

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

Możesz przekazać potok obiektu konfiguracji sesji lub ciągu zawierającego nazwę konfiguracji sesji do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych obiektów.

Uwagi

To polecenie cmdlet jest dostępne tylko na platformach systemu Windows.

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