Register-PSSessionConfiguration

Odwołanie

Moduł:: Microsoft.PowerShell.Core

Tworzy i rejestruje nową konfigurację sesji.

Składnia

Register-PSSessionConfiguration
        [-ProcessorArchitecture <String>]
        [-SessionType <PSSessionType>]
        [-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>]

Register-PSSessionConfiguration
        [-ProcessorArchitecture <String>]
        [-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>]

Register-PSSessionConfiguration
        [-ProcessorArchitecture <String>]
        [-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

Polecenie Register-PSSessionConfiguration cmdlet tworzy i rejestruje nową konfigurację sesji na komputerze lokalnym. Jest to zaawansowane polecenie cmdlet, którego można użyć do tworzenia sesji niestandardowych dla użytkowników zdalnych.

Każda sesja programu PowerShell (PSSession) używa konfiguracji sesji, znanej również jako punkt końcowy. Gdy użytkownicy tworzą sesję łączącą się z komputerem, mogą wybrać konfigurację sesji lub użyć domyślnej konfiguracji sesji zarejestrowanej podczas włączania komunikacji zdalnej programu PowerShell. Użytkownicy mogą również ustawić zmienną preferencji $PSSessionConfigurationName, która określa domyślną konfigurację sesji zdalnych utworzonych w bieżącej sesji.

Konfiguracja sesji definiuje środowisko dla sesji zdalnej. Konfiguracja może określić, które polecenia i elementy językowe są dostępne w sesji, i może zawierać ustawienia, które chronią komputer, takie jak te, które ograniczają ilość danych, które sesja może odbierać zdalnie w jednym obiekcie lub poleceniu. Deskryptor zabezpieczeń konfiguracji sesji określa, którzy użytkownicy mają uprawnienia do korzystania z konfiguracji sesji.

Elementy konfiguracji można zdefiniować przy użyciu zestawu, który implementuje nową klasę konfiguracji i za pomocą skryptu uruchamianego w sesji. Począwszy od programu PowerShell 3.0, można również użyć pliku konfiguracji sesji do zdefiniowania konfiguracji sesji.

Aby uzyskać informacje na temat konfiguracji sesji, zobacz about_Session_Configurations. Aby uzyskać informacje o plikach konfiguracji sesji, zobacz about_Session_Configuration_Files.

Przykłady

Przykład 1. Rejestrowanie konfiguracji nowej sesji programuShell

W tym przykładzie rejestrujemy konfigurację sesji programu NewShell . Parametry AssemblyName i ApplicationBase określają lokalizację pliku MyShell.dll , który określa polecenia cmdlet i dostawców w konfiguracji sesji. Parametr ConfigurationTypeName określa klasę konfiguracji do użycia z zestawu.

$sessionConfiguration = @{
    Name='NewShell'
    ApplicationBase='c:\MyShells\'
    AssemblyName='MyShell.dll'
    ConfigurationTypeName='MyClass'
}
Register-PSSessionConfiguration @sessionConfiguration

Aby użyć tej konfiguracji, wpisz New-PSSession -ConfigurationName newshell.

Przykład 2. Rejestrowanie konfiguracji sesji programu MaintenanceShell

W tym przykładzie zarejestrowano konfigurację sesji programu MaintenanceShell na komputerze lokalnym. Parametr StartupScript określa Maintenance.ps1 skrypt.

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

Gdy użytkownik używa polecenia i wybiera konfigurację New-PSSessionprogramu MaintenanceShell , Maintenance.ps1 skrypt jest uruchamiany w nowej sesji. Skrypt może skonfigurować sesję. Obejmuje to importowanie modułów i ustawianie zasad wykonywania dla sesji. Jeśli skrypt generuje błędy, w tym błędy niepowodujące zakończenia, New-PSSession polecenie zakończy się niepowodzeniem.

Przykład 3. Rejestrowanie konfiguracji sesji

W tym przykładzie zarejestrowano konfigurację sesji programu Administracja Shell.

Zmienna $sessionParams jest tabelą skrótu zawierającą wszystkie wartości parametrów. Ta tabela skrótu jest przekazywana do polecenia cmdlet przy użyciu narzędzia splatting programu PowerShell. Polecenie Register-PSSessionConfiguration używa parametru SecurityDescritorSDDL , aby określić wartość SDDL zmiennej $sddl i parametr MaximumReceivedObjectSizeMB w celu zwiększenia limitu rozmiaru obiektu. Używa również parametru StartupScript do określenia skryptu, który konfiguruje sesję.

$sddl = "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;FASA;GWGX;;;WD)"
$sessionParams = @{
    Name="AdminShell"
    SecurityDescriptorSDDL=$sddl
    MaximumReceivedObjectSizeMB=20
    StartupScript="C:\scripts\AdminShell.ps1"
}
Register-PSSessionConfiguration @sessionParams

Przykład 4. Zwracanie elementu kontenera konfiguracji

W tym przykładzie pokazano, jak zarejestrować konfigurację programu MaintenanceShell . Register-PSSessionConfigurationZwraca obiekt WSManConfigContainerElement przechowywany w zmiennej$s. Format-List wyświetla wszystkie właściwości zwróconego obiektu. Właściwość PSPath pokazuje, że obiekt jest przechowywany w katalogu dysku WSMan: . Get-ChildItem (alias dir) wyświetla elementy w ścieżce WSMan:\LocalHost\PlugIn . Obejmują one nową konfigurację programu MaintenanceShell i dwie domyślne konfiguracje, które są dostarczane z programem PowerShell.

$s = Register-PSSessionConfiguration -Name MaintenanceShell -StartupScript C:\ps-test\Maintenance.ps1
$s | Format-List -Property *
dir WSMan:\LocalHost\Plugin

PSPath            : Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell
PSParentPath      : Microsoft.WSMan.Management\WSMan::localhost\Plugin
PSChildName       : MaintenanceShell
PSDrive           : WSMan
PSProvider        : Microsoft.WSMan.Management\WSMan
PSIsContainer     : True
Keys              : {Name=MaintenanceShell}
Name              : MaintenanceShell
TypeNameOfElement : Container

Name                      Type                 Keys
----                      ----                 ----
MaintenanceShell          Container            {Name=MaintenanceShell}
microsoft.powershell      Container            {Name=microsoft.powershell}
microsoft.powershell32    Container            {Name=microsoft.powershell32}

Przykład 5. Rejestrowanie konfiguracji sesji za pomocą skryptu uruchamiania

W tym przykładzie utworzymy i zarejestrujemy konfigurację sesji WithProfile . Parametr StartupScript przekierowuje program PowerShell do uruchomienia określonego skryptu dla każdej sesji korzystającej z konfiguracji sesji.

Register-PSSessionConfiguration -Name WithProfile -StartupScript Add-Profile.ps1

Skrypt zawiera jedno polecenie, które używa określania źródła kropki do uruchamiania profilu CurrentUserAllHosts użytkownika w bieżącym zakresie sesji.

Aby uzyskać więcej informacji na temat profilów, zobacz about_Profiles. Aby uzyskać więcej informacji na temat określania źródła kropki, zobacz about_Scopes.

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:

Wyłączone. Wyłącza konfigurację sesji. Nie można go używać do zdalnego lub lokalnego dostępu do komputera.
Lokalny. Umożliwia użytkownikom komputera lokalnego korzystanie z konfiguracji sesji w celu utworzenia lokalnej sesji sprzężenia zwrotnego na tym samym komputerze, ale odmawia dostępu do użytkowników zdalnych.
Zdalnego. Umożliwia lokalnym i zdalnym użytkownikom używanie 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 Enable-PSRemoting polecenie cmdlet umożliwia zdalny dostęp do wszystkich konfiguracji sesji, Enable-PSSessionConfiguration polecenie cmdlet włącza konfiguracje sesji, a Disable-PSRemoting polecenie cmdlet uniemożliwia zdalny dostęp do wszystkich konfiguracji sesji.

Ten parametr został wprowadzony w programie PowerShell 3.0.

Type:	PSSessionConfigurationAccessMode
Accepted values:	Disabled, Local, Remote
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationBase

Określa ścieżkę pliku zestawu (*.dll), który jest określony w wartości parametru AssemblyName . Użyj tego parametru, gdy wartość parametru AssemblyName nie zawiera ścieżki. Domyślnie jest to katalog bieżący.

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

-AssemblyName

Określa nazwę pliku zestawu (*.dll), w którym zdefiniowano typ konfiguracji. Możesz określić ścieżkę .dll w tym parametrze lub w wartości parametru ApplicationBase .

Ten parametr jest wymagany podczas określania parametru ConfigurationTypeName .

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

-ConfigurationTypeName

Określa w pełni kwalifikowaną nazwę typu programu Microsoft .NET Framework, który jest używany do tej konfiguracji. Określony typ musi implementować klasę System.Management.Automation.Remoting.PSSessionConfiguration .

Aby określić plik zestawu (*.dll), który implementuje typ konfiguracji, określ parametry AssemblyName i ApplicationBase .

Tworzenie typu umożliwia kontrolowanie większej liczby aspektów konfiguracji sesji, takich jak uwidacznianie lub ukrywanie niektórych parametrów poleceń cmdlet lub ustawianie limitów rozmiaru danych i rozmiaru obiektu, których użytkownicy nie mogą zastąpić.

Jeśli pominiesz ten parametr, dla konfiguracji sesji zostanie użyta klasa DefaultRemotePowerShellConfiguration .

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

-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

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, określ parametr NoServiceRestart .

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 i wartość tego parametru jest ignorowana.

Type:	Nullable<T>[Double]
Position:	Named
Default value:	50
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumReceivedObjectSizeMB

Określa limit 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 i wartość tego parametru jest ignorowana.

Type:	Nullable<T>[Double]
Position:	Named
Default value:	10
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ModulesToImport

Określa moduły, które są automatycznie importowane do sesji korzystających z konfiguracji sesji.

Domyślnie tylko program Microsoft.PowerShell.Core jest importowany do sesji. Jeśli polecenia cmdlet nie zostaną wykluczone, możesz użyć Import-Module polecenia , aby dodać moduły do sesji.

Moduły określone w tej wartości parametru są importowane oprócz modułów, które są określone przez parametr SessionType i wymienione w kluczu ModulesToImport 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.

Ten parametr został wprowadzony w programie PowerShell 3.0.

Type:	Object[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Określa nazwę konfiguracji sesji. Ten parametr jest wymagany.

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

-NoServiceRestart

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

Domyślnie po uruchomieniu Register-PSSessionConfiguration polecenia zostanie 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, określ parametr Force . Aby ręcznie uruchomić ponownie usługę WinRM , użyj Restart-Service polecenia cmdlet .

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

-Path

Określa ścieżkę i nazwę pliku konfiguracji sesji (pssc), taki jak jeden utworzony przez New-PSSessionConfigurationFile. Jeśli pominięto ścieżkę, wartość domyślna to bieżący katalog.

Ten parametr został wprowadzony w programie PowerShell 3.0.

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

-ProcessorArchitecture

Określa, czy 32-bitowa czy 64-bitowa wersja procesu programu PowerShell jest uruchamiana w sesjach korzystających z tej konfiguracji sesji. Dopuszczalne wartości tego parametru to: x86 (32-bitowe) i AMD64 (64-bitowe). Wartość domyślna jest określana przez architekturę procesora komputera, który hostuje konfigurację sesji.

Tego parametru można użyć do utworzenia 32-bitowej sesji na komputerze 64-bitowym. Próba utworzenia 64-bitowego procesu na komputerze 32-bitowym kończy się niepowodzeniem.

Type:	String
Aliases:	PA
Accepted values:	x86, amd64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Version
Aliases:	PowerShellVersion
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-SecurityDescriptorSddl

Określa 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 Do wykonywania (wywołania) dla konfiguracji.

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

W przypadku pominięcia tego parametru główny plik SDDL dla usługi WinRM jest używany do tej konfiguracji. Aby wyświetlić lub zmienić główny plik SDDL, użyj dostawcy WSMan. Na przykład: Get-Item wsman:\localhost\service\rootSDDL. Aby uzyskać więcej informacji na temat dostawcy WSMan, wpisz Get-Help wsman.

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

-SessionType

Określa typ sesji, który jest tworzony przy użyciu konfiguracji sesji. Dopuszczalne wartości tego parametru to:

Pusty. Domyślnie do sesji nie są dodawane żadne moduły. Użyj parametrów tego polecenia cmdlet, aby dodać moduły, funkcje, skrypty i inne funkcje do sesji.
Domyślne. Dodaje program Microsoft.PowerShell.Core do sesji. Ten moduł zawiera Import-Module polecenie cmdlet, którego użytkownicy mogą używać do importowania innych modułów, chyba że jawnie zabronisz polecenia cmdlet.
RestrictedRemoteServer. Obejmuje tylko następujące polecenia cmdlet: Exit-PSSession, , Get-Command, Get-FormatDataGet-Help, Measure-Object, Out-Default, i Select-Object. Użyj skryptu lub zestawu lub kluczy w pliku konfiguracji sesji, aby dodać moduły, funkcje, skrypty i inne funkcje do sesji.

Wartość domyślna to Wartość domyślna.

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

Ten parametr został wprowadzony w programie PowerShell 3.0.

Type:	PSSessionType
Accepted values:	DefaultRemoteShell, Workflow
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SessionTypeOption

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

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 New-PSSessionOption polecenia cmdlet, 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.

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

-ShowSecurityDescriptorUI

Wskazuje, że to polecenie cmdlet wyświetla arkusz właściwości, który ułatwia utworzenie sdDL dla konfiguracji sesji. Po wprowadzeniu Register-PSSessionConfiguration polecenia zostanie wyświetlony arkusz właściwości, a następnie uruchom ponownie usługę WinRM .

Podczas ustawiania uprawnień do konfiguracji należy pamiętać, że użytkownicy muszą mieć co najmniej uprawnienie Wykonaj (Wywołaj), aby móc korzystać z konfiguracji sesji w sesji.

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

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

-StartupScript

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

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

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

-ThreadApartmentState

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

Type:	ApartmentState
Accepted values:	STA, MTA, Unknown
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ThreadOptions

Określa, jak wątki są tworzone i używane, gdy polecenie jest uruchamiane w sesji. Dopuszczalne wartości tego parametru to:

Wartość domyślna
Ponowne użycieWczystego
UseCurrentThread
UseNewThread

Wartość domyślna to UseCurrentThread.

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

Type:	PSThreadOptions
Accepted values:	Default, UseNewThread, ReuseThread, UseCurrentThread
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TransportOption

Określa opcję transportu.

Ten parametr został wprowadzony w programie PowerShell 3.0.

Type:	PSTransportOption
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

None

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

Dane wyjściowe

WSManConfigContainerElement

Uwagi

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

To polecenie cmdlet generuje kod XML reprezentujący konfigurację wtyczki web services for Management (WS-Management) i wysyła kod XML do usługi WS-Management, który rejestruje wtyczkę na komputerze lokalnym (New-Item wsman:\localhost\plugin).

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.

Register-PSSessionConfiguration

Składnia

Opis

Przykłady

Przykład 1. Rejestrowanie konfiguracji nowej sesji programuShell

Przykład 2. Rejestrowanie konfiguracji sesji programu MaintenanceShell

Przykład 3. Rejestrowanie konfiguracji sesji

Przykład 4. Zwracanie elementu kontenera konfiguracji

Przykład 5. Rejestrowanie konfiguracji sesji za pomocą skryptu uruchamiania

Parametry

-AccessMode

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-ProcessorArchitecture

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionType

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Dane wejściowe

Dane wyjściowe

Uwagi

Opinia

Dodatkowe zasoby

Register-PSSessionConfiguration

Składnia

Opis

Przykłady

Przykład 1. Rejestrowanie konfiguracji nowej sesji programuShell

Przykład 2. Rejestrowanie konfiguracji sesji programu MaintenanceShell

Przykład 3. Rejestrowanie konfiguracji sesji

Przykład 4. Zwracanie elementu kontenera konfiguracji

Przykład 5. Rejestrowanie konfiguracji sesji za pomocą skryptu uruchamiania

Parametry

-AccessMode

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-ProcessorArchitecture

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionType

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Opinia

Dodatkowe zasoby