Udostępnij za pośrednictwem

Set-PSSessionConfiguration

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

Zmienia właściwości konfiguracji zarejestrowanej sesji.

Składnia

Set-PSSessionConfiguration
   [-Name] <String>
   [-ApplicationBase <String>]
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-PSVersion <Version>]
   [-SessionTypeOption <PSSessionTypeOption>]
   [-TransportOption <PSTransportOption>]
   [-ModulesToImport <Object[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-PSSessionConfiguration
   [-Name] <String>
   [-AssemblyName] <String>
   [-ApplicationBase <String>]
   [-ConfigurationTypeName] <String>
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-PSVersion <Version>]
   [-SessionTypeOption <PSSessionTypeOption>]
   [-TransportOption <PSTransportOption>]
   [-ModulesToImport <Object[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-PSSessionConfiguration
   [-Name] <String>
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-TransportOption <PSTransportOption>]
   -Path <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

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

Polecenie cmdlet Set-PSSessionConfiguration zmienia właściwości konfiguracji sesji na komputerze lokalnym.

Użyj parametru Name, aby zidentyfikować konfigurację sesji, którą chcesz zmienić. Użyj innych parametrów, aby określić nowe wartości właściwości konfiguracji sesji. Aby usunąć wartość właściwości z konfiguracji i użyć wartości domyślnej, wprowadź pusty ciąg ("") lub wartość $Null odpowiedniego parametru.

Począwszy od programu PowerShell 3.0, można użyć pliku konfiguracji sesji do zdefiniowania konfiguracji sesji. Ta funkcja udostępnia prostą i wykrywalną metodę ustawiania i zmieniania właściwości sesji korzystających z konfiguracji sesji. Aby określić plik konfiguracji sesji, użyj parametru ścieżki Set-PSSessionConfiguration. Aby uzyskać informacje o plikach konfiguracji sesji, zobacz about_Session_Configuration_Files. Aby uzyskać informacje o sposobie tworzenia i modyfikowania pliku konfiguracji sesji, zobacz polecenie cmdlet New-PSSessionConfigurationFile.

Konfiguracje sesji definiują środowisko sesji zdalnych (psSessions), które łączą się z komputerem lokalnym. Każda pssession używa konfiguracji sesji. Konfiguracja sesji określa funkcje PSSession, takie jak moduły dostępne w sesji, polecenia cmdlet, które mogą być uruchamiane, tryb języka, przydziały i limity czasu. Deskryptor zabezpieczeń konfiguracji sesji określa, kto może używać konfiguracji sesji do nawiązywania połączenia z komputerem lokalnym. Aby uzyskać więcej informacji na temat konfiguracji sesji, zobacz about_Session_Configurations.

Aby wyświetlić właściwości konfiguracji sesji, użyj polecenia cmdlet Get-PSSessionConfiguration lub dostawcy WSMan. Aby uzyskać więcej informacji na temat dostawcy WSMan, wpisz Get-Help WSMan.

Przykłady

Przykład 1. Tworzenie i zmienianie konfiguracji sesji

W tym przykładzie pokazano, jak dodać i usunąć skrypt uruchamiania z konfiguracji.

Pierwsze polecenie tworzy konfigurację AdminShell. Drugie polecenie dodaje skrypt AdminConfig.ps1 do konfiguracji. Zmiana jest obowiązująca po ponownym uruchomieniu usługi WinRM. Trzecie polecenie usuwa skrypt AdminConfig.ps1 z konfiguracji.

Register-PSSessionConfiguration -Name "AdminShell" -AssemblyName "C:\Shells\AdminShell.dll" -ConfigurationTypeName "AdminClass"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript "AdminConfig.ps1"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript $Null

Przykład 2. Wyświetlanie wyników

Ten przykład zwiększa wartość właściwości MaximumReceivedObjectSizeMB w celu 20. To polecenie wyświetla również monit o ponowne uruchomienie usługi WinRM. Zmiana nie zostanie obowiązująca do momentu ponownego uruchomienia usługi WinRM.

Set-PSSessionConfiguration -Name "IncObj" -MaximumReceivedObjectSizeMB 20

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\IncObj\InitializationParameters

ParamName                       ParamValue
---------                       ----------
psmaximumreceivedobjectsizemb   20

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Przykład 3. Wyświetlanie wyników na różne sposoby

W tym przykładzie Set-PSSessionConfiguration zmiany skryptu uruchamiania w konfiguracji sesji programu MaintenanceShell w celu Maintenance.ps1. Dane wyjściowe pokazują zmianę i monituje o ponowne uruchomienie usługi WinRM. Odpowiedź to y (tak).

Get-PSSessionConfiguration pobiera konfigurację sesji MaintenanceShell. Operator potoku (|) wysyła wyniki polecenia do Format-List, który wyświetla wszystkie właściwości obiektu konfiguracji na liście. Następnie przy użyciu dostawcy WSMan wyświetlimy parametry inicjowania konfiguracji programu MaintenanceShell. Get-ChildItem pobiera elementy podrzędne w węźle InitializationParameters dla wtyczki programu MaintenanceShell. Aby uzyskać więcej informacji na temat dostawcy WSMan, wpisz Get-Help wsman.

Set-PSSessionConfiguration -Name "MaintenanceShell" -StartupScript "C:\ps-test\Maintenance.ps1"

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName            ParamValue
---------            ----------
startupscript        c:\ps-test\Mainte...

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run
the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Get-PSSessionConfiguration MaintenanceShell | Format-List -Property *

xmlns            : http://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Name             : MaintenanceShell
Filename         : %windir%\system32\pwrshplugin.dll
SDKVersion       : 1
XmlRenderingType : text
lang             : en-US
PSVersion        : 2.0
startupscript    : c:\ps-test\Maintenance.ps1
ResourceUri      : http://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch       : true
Capability       : {Shell}
Permission       :

Get-ChildItem WSMan:\localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName     ParamValue
---------     ----------
PSVersion     2.0
startupscript c:\ps-test\Maintenance.ps1

Parametry

-AccessMode

Włącza i wyłącza konfigurację sesji i określa, czy może być używany na potrzeby sesji zdalnych lub lokalnych na komputerze. Dopuszczalne wartości tego parametru to:

  • Disabled. Wyłącza konfigurację sesji. Nie można go używać do zdalnego lub lokalnego dostępu do komputera. Ta wartość ustawia właściwość Enabled konfiguracji sesji (WSMan:\<ComputerName>\PlugIn\<SessionConfigurationName>\Enabled) na False.
  • Local. Dodaje wpis Network_Deny_All do deskryptora zabezpieczeń konfiguracji sesji. Użytkownicy komputera lokalnego mogą używać konfiguracji sesji do tworzenia lokalnej sesji sprzężenia zwrotnego na tym samym komputerze, ale użytkownicy zdalni nie mają dostępu.
  • Remote. Usuwa wpisy Deny_All i Network_Deny_All z deskryptorów zabezpieczeń konfiguracji sesji. Użytkownicy komputerów lokalnych i zdalnych mogą używać konfiguracji sesji do tworzenia sesji i uruchamiania poleceń na tym komputerze.

Wartość domyślna to Remote.

Inne polecenia cmdlet mogą później zastąpić wartość tego parametru. Na przykład polecenie cmdlet Enable-PSRemoting włącza wszystkie konfiguracje sesji na komputerze i zezwala na dostęp zdalny do nich, a polecenie cmdlet Disable-PSRemoting zezwala tylko na dostęp lokalny do wszystkich konfiguracji sesji na komputerze.

Ten parametr został wprowadzony w programie PowerShell 3.0.

Typ:PSSessionConfigurationAccessMode
Dopuszczalne wartości:Disabled, Local, Remote
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ApplicationBase

Określa ścieżkę pliku zestawu (*.dll), który jest określony w wartości parametru AssemblyName.

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

-AssemblyName

Określa nazwę zestawu. To polecenie cmdlet tworzy konfigurację sesji na podstawie klasy zdefiniowanej w zestawie.

Wprowadź nazwę pliku lub pełną ścieżkę pliku .dll zestawu, który definiuje konfigurację sesji. Jeśli wprowadzisz tylko nazwę pliku, możesz wprowadzić ścieżkę w wartości parametru ApplicationBase.

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

-ConfigurationTypeName

Określa typ konfiguracji sesji zdefiniowanej w zestawie w AssemblyName parametru. Określony typ musi implementować klasę System.Management.Automation.Remoting.PSSessionConfiguration.

Ten parametr jest wymagany podczas określania nazwy zestawu.

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

-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

Pomija wszystkie monity użytkownika 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

-MaximumReceivedDataSizePerCommandMB

Określa limit ilości danych, które mogą być wysyłane do tego komputera w dowolnym pojedynczym poleceniu zdalnym. Wprowadź rozmiar danych w megabajtach (MB). Wartość domyślna to 50.

Jeśli limit rozmiaru danych jest zdefiniowany w typie konfiguracji określonym w parametrze ConfigurationTypeName, używany jest limit w typie konfiguracji. Wartość tego parametru jest ignorowana.

Typ:Nullable<T>[Double]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MaximumReceivedObjectSizeMB

Określa limity ilości danych, które mogą być wysyłane do tego komputera w dowolnym pojedynczym obiekcie. Wprowadź rozmiar danych w megabajtach. Wartość domyślna to 10.

Jeśli limit rozmiaru obiektu jest zdefiniowany w typie konfiguracji określonym w parametrze ConfigurationTypeName, używany jest limit w typie konfiguracji. Wartość tego parametru jest ignorowana.

Typ:Nullable<T>[Double]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ModulesToImport

Określa moduły i przystawki, które są automatycznie importowane do sesji korzystających z konfiguracji sesji. Wprowadź moduł i nazwy przystawek.

Domyślnie tylko moduł Microsoft.PowerShell.Core jest importowany do sesji, ale jeśli polecenia cmdlet nie zostaną wykluczone, można użyć poleceń cmdlet Import-Module i Add-PSSnapin, aby dodać moduły i przystawki do sesji.

Moduły określone w tej wartości parametru są importowane oprócz modułów określonych w pliku konfiguracji sesji (New-PSSessionConfigurationFile). Jednak ustawienia w pliku konfiguracji sesji mogą ukrywać polecenia wyeksportowane przez moduły lub uniemożliwić użytkownikom korzystanie z nich.

Moduły określone w tej wartości parametru zastępują listę modułów określonych za pomocą parametru ModulesToImport polecenia cmdlet Register-PSSessionConfiguration.

Ten parametr został wprowadzony w programie PowerShell 3.0.

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

-Name

Określa nazwę konfiguracji sesji, którą chcesz zmienić.

Nie można użyć tego parametru, aby zmienić nazwę konfiguracji sesji.

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

-NoServiceRestart

Nie uruchamia ponownie usługi winRM i pomija monit o ponowne uruchomienie usługi.

Domyślnie po uruchomieniu Set-PSSessionConfigurationzostanie wyświetlony monit o ponowne uruchomienie usługi WinRM w celu wprowadzenia nowej konfiguracji sesji. Dopóki usługa WinRM nie zostanie ponownie uruchomiona, nowa konfiguracja sesji nie będzie skuteczna.

Aby ponownie uruchomić usługę WinRM bez monitowania, użyj parametru Force. Aby ręcznie uruchomić ponownie usługę WinRM, użyj polecenia cmdlet Restart-Service.

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

-Path

Określa ścieżkę pliku konfiguracji sesji (.pssc), na przykład ścieżkę utworzoną przez polecenie cmdlet New-PSSessionConfigurationFile. Jeśli pominięto ścieżkę, wartość domyślna to bieżący katalog.

Aby uzyskać informacje na temat modyfikowania pliku konfiguracji sesji, zobacz temat pomocy dla polecenia cmdlet New-PSSessionConfigurationFile.

Ten parametr został wprowadzony w programie PowerShell 3.0.

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

-PSVersion

Określa wersję programu PowerShell w sesjach korzystających z tej konfiguracji sesji.

Wartość tego parametru ma pierwszeństwo przed wartością klucza PowerShellVersion w pliku konfiguracji sesji.

Ten parametr został wprowadzony w programie PowerShell 3.0.

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

-RunAsCredential

Określa poświadczenia dla poleceń w sesji. Domyślnie polecenia są uruchamiane z uprawnieniami bieżącego użytkownika.

Ten parametr został wprowadzony w programie PowerShell 3.0.

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

-SecurityDescriptorSddl

Określa inny ciąg języka SDDL (Security Descriptor Definition Language) dla konfiguracji.

Ten ciąg określa uprawnienia wymagane do korzystania z nowej konfiguracji sesji. Aby użyć konfiguracji sesji w sesji, użytkownicy muszą mieć co najmniej Execute(Invoke) uprawnienia do konfiguracji.

Aby użyć domyślnego deskryptora zabezpieczeń dla konfiguracji, wprowadź pusty ciąg ("") lub wartość $Null. Wartość domyślna to główny plik SDDL na dysku WSMan:.

Jeśli deskryptor zabezpieczeń jest złożony, rozważ użycie parametru ShowSecurityDescriptorUI zamiast tego. Nie można użyć obu parametrów w tym samym poleceniu.

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

-SessionTypeOption

Określa opcje specyficzne dla typu dla konfiguracji sesji. Wprowadź obiekt opcji typu sesji, taki jak obiekt PSWorkflowExecutionOption zwracany przez polecenie cmdlet New-PSWorkflowExecutionOption.

Opcje sesji używających konfiguracji sesji są określane przez wartości opcji sesji i opcji konfiguracji sesji. O ile nie określono, opcje ustawione w sesji, takie jak w przypadku polecenia cmdlet New-PSSessionOption, mają pierwszeństwo przed opcjami ustawionymi w konfiguracji sesji. Jednak wartości opcji sesji nie mogą przekraczać maksymalnych wartości ustawionych w konfiguracji sesji.

Ten parametr został wprowadzony w programie PowerShell 3.0.

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

-ShowSecurityDescriptorUI

Gdy ten parametr jest używany, polecenie cmdlet otwiera arkusz właściwości, który pomaga utworzyć nowy plik SDDL dla konfiguracji sesji. Arkusz właściwości zostanie wyświetlony po uruchomieniu polecenia Set-PSSessionConfiguration, a następnie uruchom ponownie usługę WinRM.

Po ustawieniu uprawnień do konfiguracji należy pamiętać, że użytkownicy muszą mieć co najmniej Execute(Invoke) uprawnienia do korzystania z konfiguracji sesji w sesji.

Nie można użyć parametru SecurityDescriptorSDDL i tego parametru w tym samym poleceniu.

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

-StartupScript

Określa skrypt uruchamiania konfiguracji. Wprowadź w pełni kwalifikowaną ścieżkę skryptu programu PowerShell. Określony skrypt jest uruchamiany w nowej sesji, która używa konfiguracji sesji.

Aby usunąć skrypt uruchamiania z konfiguracji sesji, wprowadź pusty ciąg ("") lub wartość $Null.

Możesz użyć skryptu uruchamiania, aby jeszcze bardziej skonfigurować sesję użytkownika. Jeśli skrypt generuje błąd, nawet błąd bez zakończenia, sesja nie zostanie utworzona i polecenie New-PSSession zakończy się niepowodzeniem.

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

-ThreadApartmentState

Określa stan mieszkania modułu wątkowego do użycia. Dopuszczalne wartości to:

  • Unknown
  • MTA
  • STA
Typ:ApartmentState
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ThreadOptions

Określa ustawienie opcji wątku w konfiguracji. To ustawienie definiuje sposób tworzenia wątków i ich użycia podczas wykonywania polecenia w sesji. Dopuszczalne wartości tego parametru to:

  • Default
  • ReuseThread
  • UseCurrentThread
  • UseNewThread

Wartość domyślna to UseCurrentThread.

Aby uzyskać więcej informacji, zobacz PSThreadOptions Enumeration.

Typ:PSThreadOptions
Dopuszczalne wartości:Default, UseNewThread, ReuseThread, UseCurrentThread
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TransportOption

Określa opcje transportu konfiguracji sesji. Wprowadź obiekt opcji transportu, taki jak obiekt WSManConfigurationOption zwracany przez polecenie cmdlet New-PSTransportOption.

Opcje sesji używających konfiguracji sesji są określane przez wartości opcji sesji i opcji konfiguracji sesji. O ile nie określono, opcje ustawione w sesji, takie jak w przypadku polecenia cmdlet New-PSSessionOption, mają pierwszeństwo przed opcjami ustawionymi w konfiguracji sesji. Jednak wartości opcji sesji nie mogą przekraczać maksymalnych wartości ustawionych w konfiguracji sesji.

Ten parametr został wprowadzony w programie PowerShell 3.0.

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

-UseSharedProcess

Użyj tylko jednego procesu do hostowania wszystkich sesji, które są uruchamiane przez tego samego użytkownika i używają tej samej konfiguracji sesji. Domyślnie każda sesja jest hostowana we własnym procesie.

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

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

WSManConfigLeafElement

Uwagi

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

Aby uruchomić to polecenie cmdlet, uruchom program PowerShell przy użyciu opcji Uruchom jako administrator.

Polecenie cmdlet Set-PSSessionConfiguration nie zmienia nazwy konfiguracji, a dostawca WSMan nie obsługuje polecenia cmdlet Rename-Item. Aby zmienić nazwę konfiguracji sesji, użyj polecenia cmdlet Unregister-PSSessionConfiguration, aby usunąć konfigurację, a następnie użyć polecenia cmdlet Register-PSSessionConfiguration do utworzenia i zarejestrowania nowej konfiguracji sesji.

Możesz użyć polecenia cmdlet Set-PSSessionConfiguration, aby zmienić domyślne konfiguracje Microsoft.PowerShell i Microsoft.PowerShell32 sesji. Nie są one chronione. Aby przywrócić oryginalną wersję domyślnej konfiguracji sesji, użyj polecenia cmdlet Unregister-PSSessionConfiguration, aby usunąć konfigurację sesji domyślnej, a następnie użyć polecenia cmdlet Enable-PSRemoting, aby go przywrócić.

Właściwości obiektu konfiguracji sesji różnią się w zależności od opcji ustawionych dla konfiguracji sesji i wartości tych opcji. Ponadto konfiguracje sesji korzystające z pliku konfiguracji sesji mają dodatkowe właściwości.

Aby zmienić właściwości konfiguracji sesji, możesz użyć poleceń na dysku WSMan:. Nie można jednak użyć dysku WSMan: w programie PowerShell 2.0, aby zmienić właściwości konfiguracji sesji wprowadzone w programie PowerShell 3.0, takie jak OutputBufferingMode. Polecenia programu Windows PowerShell 2.0 nie generują błędu, ale są nieskuteczne. Aby zmienić właściwości wprowadzone w programie PowerShell 3.0, użyj dysku WSMan: w programie PowerShell 3.0 lub nowszym.