Set-PSSessionConfiguration

Moduł:

Microsoft.PowerShell.Core Module

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

Składnia

NameParameterSet (domyślnie)

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>]

AssemblyNameParameterSet

Set-PSSessionConfiguration
    [-Name] <String>
    [-AssemblyName] <String>
    [-ConfigurationTypeName] <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>]

SessionConfigurationFile

Set-PSSessionConfiguration
    [-Name] <String>
    -Path <String>
    [-RunAsCredential <PSCredential>]
    [-ThreadApartmentState <ApartmentState>]
    [-ThreadOptions <PSThreadOptions>]
    [-AccessMode <PSSessionConfigurationAccessMode>]
    [-UseSharedProcess]
    [-StartupScript <String>]
    [-MaximumReceivedDataSizePerCommandMB <Double>]
    [-MaximumReceivedObjectSizeMB <Double>]
    [-SecurityDescriptorSddl <String>]
    [-ShowSecurityDescriptorUI]
    [-Force]
    [-NoServiceRestart]
    [-TransportOption <PSTransportOption>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

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. Zmiana stanu mieszkania wątku

PS C:\> Set-PSSessionConfiguration -Name "MaintenanceShell" -ThreadApartmentState STA

To polecenie zmienia stan mieszkania wątku w konfiguracji programu MaintenanceShell na STA. Zmiana jest obowiązująca po ponownym uruchomieniu usługi WinRM.

Przykład 2. 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 3. Wyświetlanie wyników

Ten przykład zwiększa wartość właściwości MaximumReceivedObjectSizeMB do 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 4. Wyświetlanie wyników na różne sposoby

W tym przykładzie zmiany skryptu uruchamiania w konfiguracji sesji programu MaintenanceShell w celu . 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 w celu 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 (alias dir) 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.

PS> 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

PS> Get-PSSessionConfiguration MaintenanceShell | Format-List -Property *

xmlns            : https://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      : https://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch       : true
Capability       : {Shell}
Permission       :

PS> dir 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:

• Niepełnosprawny. 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 () na wartość False.
• Lokalny. 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.
• Zdalny. 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.

Właściwości parametru

Typ:	PSSessionConfigurationAccessMode
Domyślna wartość:	None
Dopuszczalne wartości:	Disabled, Local, Remote
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-ApplicationBase

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

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

NameParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

AssemblyNameParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

AssemblyNameParameterSet

Position:	1
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

AssemblyNameParameterSet

Position:	2
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	por

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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 MB.

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.

Właściwości parametru

Typ:	Double
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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 MB.

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.

Właściwości parametru

Typ:	Double
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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 przystawka Microsoft.PowerShell.Core jest importowana do sesji, ale chyba że polecenia cmdlet zostaną wykluczone, można użyć Import-Module i Add-PSSnapin poleceń cmdlet, 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 przy użyciu parametru ModulesToImport polecenia cmdlet Register-PSSessionConfiguration.

Ten parametr został wprowadzony w programie PowerShell 3.0.

Właściwości parametru

Typ:	Object[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

NameParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

AssemblyNameParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Name

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

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

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	0
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

SessionConfigurationFile

Position:	Named
Obowiązkowe:	True
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	Version
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	PowerShellVersion

Zestawy parametrów

NameParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

AssemblyNameParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	PSCredential
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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 uprawnienie Execute(Invoke) dla 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.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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 przy użyciu 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.

Właściwości parametru

Typ:	PSSessionTypeOption
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

NameParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

AssemblyNameParameterSet

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-ShowSecurityDescriptorUI

Wskazuje, że to polecenie cmdlet zawiera arkusz właściwości, który ułatwia utworzenie nowego zestawu 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 uprawnienie Execute(Invoke) do korzystania z konfiguracji sesji w sesji.

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

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-ThreadApartmentState

Określa ustawienie stanu mieszkania dla wątków w sesji. Dopuszczalne wartości tego parametru to: STA, MTA i Unknown. Wartość domyślna to Nieznany.

Właściwości parametru

Typ:	ApartmentState
Domyślna wartość:	None
Dopuszczalne wartości:	STA, MTA, Unknown
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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:

• Wartość domyślna
• Ponowne użycieWczystego
• UżyjBieżący wątek
• Posługiwać sięNowy wątek

Wartość domyślna to UseCurrentThread.

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

Właściwości parametru

Typ:	PSThreadOptions
Domyślna wartość:	None
Dopuszczalne wartości:	Default, UseNewThread, ReuseThread, UseCurrentThread
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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 przy użyciu 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.

Właściwości parametru

Typ:	PSTransportOption
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	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.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-WhatIf

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

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	False
Obsługuje symbole wieloznaczne:	False
DontShow:	False
Aliasy:	Wi

Zestawy parametrów

(All)

Position:	Named
Obowiązkowe:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Nie można przekazać danych wejściowych potoku do tego polecenia cmdlet.

Dane wyjściowe

WSManConfigLeafElement

Uwagi

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 sesji Microsoft.PowerShell i Microsoft.PowerShell32. 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.

Można użyć poleceń w programie WSMan:, aby zmienić właściwości konfiguracji sesji. Nie można jednak użyć napędu WSMan: w PowerShell 2.0, aby zmienić właściwości konfiguracji sesji wprowadzone w 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 programu WSMan: dysku w programie PowerShell 3.0.

Linki powiązane

• Wyłącz-PSSessionConfiguration
• Włącz-PSSessionConfiguration
• Get-PSSessionConfiguration
• New-PSSessionConfigurationFile
• Opcja-NowejSesjiPS
• New-PSTransportOption
• New-PSWorkflowExecutionOption
• Rejestracja konfiguracji sesji PowerShell (`Register-PSSessionConfiguration`)
• Test-PSSessionConfigurationFile
• Unregister-PSSessionConfiguration
• Dostawca programu WSMan
• o_konfiguracjach_sesji
• o_Plikach_Konfiguracji_Sesji