Sdílet prostřednictvím

Set-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

Změní vlastnosti registrované konfigurace relace.

Syntax

NameParameterSet (Výchozí) 

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

Description

Tato rutina je dostupná jenom na platformě Windows.

Rutina Set-PSSessionConfiguration změní vlastnosti konfigurace relací v místním počítači.

Pomocí parametru Name identifikujte konfiguraci relace, kterou chcete změnit. Pomocí dalších parametrů můžete zadat nové hodnoty vlastností konfigurace relace. Pokud chcete z konfigurace odstranit hodnotu vlastnosti a použít výchozí hodnotu, zadejte prázdný řetězec ("") nebo hodnotu $Null pro odpovídající parametr.

Počínaje PowerShellem 3.0 můžete definovat konfiguraci relace pomocí konfiguračního souboru relace. Tato funkce poskytuje jednoduchou a zjistitelnou metodu pro nastavení a změnu vlastností relací, které používají konfiguraci relace. Chcete-li zadat konfigurační soubor relace, použijte Path parametr Set-PSSessionConfiguration. Informace o souborech konfigurace relací najdete v tématu about_Session_Configuration_Files. Informace o tom, jak vytvořit a upravit konfigurační soubor relace, najdete v rutině New-PSSessionConfigurationFile.

Konfigurace relací definují prostředí vzdálených relací (psSessions), které se připojují k místnímu počítači. Každá PSSession používá konfiguraci relace. Konfigurace relace určuje funkce PSSession , jako jsou moduly dostupné v relaci, rutiny, které mají povoleno spouštět, režim jazyka, kvóty a časové limity. Popisovač zabezpečení konfigurace relace určuje, kdo může použít konfiguraci relace pro připojení k místnímu počítači. Další informace o konfiguracích relací naleznete v části about_Session_Configurations.

Pokud chcete zobrazit vlastnosti konfigurace relace, použijte rutinu Get-PSSessionConfiguration nebo zprostředkovatele WSMan. Další informace o zprostředkovateli WSMan zadejte Get-Help WSMan.

Příklady

Příklad 1: Vytvoření a změna konfigurace relace

Tento příklad ukazuje, jak přidat a odebrat spouštěcí skript z konfigurace.

První příkaz vytvoří konfiguraci AdminShellu. Druhý příkaz přidá do konfigurace AdminConfig.ps1 skript. Změna je efektivní při restartování WinRM. Třetí příkaz odebere AdminConfig.ps1 skript z konfigurace.

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

Příklad 2: Zobrazení výsledků

Tento příklad zvyšuje hodnotu MaximumReceivedObjectSizeMB vlastnost 20. Tento příkaz vás také vyzve k restartování služby WinRM. Tato změna není platná, dokud se nerestartuje služba 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

Příklad 3: Zobrazení výsledků různými způsoby

V tomto příkladu Set-PSSessionConfiguration změní spouštěcí skript v konfiguraci relace MaintenanceShellu na Maintenance.ps1. Ve výstupu se zobrazí změna a zobrazí se výzva k restartování služby WinRM. Odpověď je y (ano).

Get-PSSessionConfiguration získá konfiguraci relace MaintenanceShellu. Operátor kanálu (|) odešle výsledky příkazu do Format-List, který zobrazí všechny vlastnosti objektu konfigurace v seznamu. Dále pomocí zprostředkovatele WSMan zobrazíme inicializační parametry pro konfiguraci MaintenanceShellu. Get-ChildItem získá podřízené položky v uzlu InitializationParameters modulu plug-in Maintenance Shell. Další informace o zprostředkovateli WSMan zadejte 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

Povolí a zakáže konfiguraci relace a určí, jestli se dá použít pro vzdálené nebo místní relace v počítači. Přijatelné hodnoty pro tento parametr jsou:

  • Disabled. Zakáže konfiguraci relace. Nelze jej použít pro vzdálený nebo místní přístup k počítači. Tato hodnota nastaví vlastnost Enabled konfigurace relace (WSMan:\<ComputerName>\PlugIn\<SessionConfigurationName>\Enabled) na False.
  • Local. Přidá položku Network_Deny_All do popisovače zabezpečení konfigurace relace. Uživatelé místního počítače mohou pomocí konfigurace relace vytvořit relaci zpětné smyčky na stejném počítači, ale vzdáleným uživatelům je odepřen přístup.
  • Remote. Odebere Deny_All a Network_Deny_All položky z popisovačů zabezpečení konfigurace relace. Uživatelé místních a vzdálených počítačů mohou pomocí konfigurace relace vytvářet relace a spouštět příkazy na tomto počítači.

Výchozí hodnota je Vzdálené.

Další rutiny mohou později přepsat hodnotu tohoto parametru. Například rutina Enable-PSRemoting povolí všechny konfigurace relací v počítači a povolí jim vzdálený přístup a rutina Disable-PSRemoting umožňuje pouze místní přístup ke všem konfiguracím relací v počítači.

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

Typ:PSSessionConfigurationAccessMode
Default value:None
Přípustné hodnoty:Disabled, Local, Remote
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ApplicationBase

Určuje cestu k souboru sestavení (*.dll), který je zadán v hodnotě parametru AssemblyName.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

NameParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
AssemblyNameParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-AssemblyName

Určuje název sestavení. Tato rutina vytvoří konfiguraci relace na základě třídy definované v sestavení.

Zadejte název souboru nebo úplnou cestu k souboru sestavení .dll, který definuje konfiguraci relace. Pokud zadáte pouze název souboru, můžete zadat cestu do hodnoty ApplicationBase parametru.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

AssemblyNameParameterSet
Position:1
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ConfigurationTypeName

Určuje typ konfigurace relace, která je definována v sestavení v AssemblyName parametru. Zadaný typ musí implementovat System.Management.Automation.Remoting.PSSessionConfiguration třídy.

Tento parametr se vyžaduje při zadání názvu sestavení.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

AssemblyNameParameterSet
Position:2
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Force

Potlačí všechny výzvy uživatele a restartuje službu WinRM bez výzvy. Restartováním služby se změna konfigurace projeví.

Pokud chcete zabránit restartování a potlačit výzvu k restartování, použijte parametr NoServiceRestart.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MaximumReceivedDataSizePerCommandMB

Určuje limit množství dat, která lze odeslat do tohoto počítače v libovolném vzdáleném příkazu. Zadejte velikost dat v megabajtech (MB). Výchozí hodnota je 50.

Pokud je limit velikosti dat definován v typu konfigurace zadaném v parametru ConfigurationTypeName, použije se limit typu konfigurace. Hodnota tohoto parametru je ignorována.

Vlastnosti parametru

Typ:

Nullable<T>[Double]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MaximumReceivedObjectSizeMB

Určuje omezení množství dat, která lze odeslat do tohoto počítače v libovolném objektu. Zadejte velikost dat v megabajtech. Výchozí hodnota je 10.

Pokud je limit velikosti objektu definován v typu konfigurace zadaném v parametru ConfigurationTypeName, použije se limit typu konfigurace. Hodnota tohoto parametru je ignorována.

Vlastnosti parametru

Typ:

Nullable<T>[Double]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ModulesToImport

Určuje moduly a moduly snap-in, které se automaticky importují do relací, které používají konfiguraci relace. Zadejte názvy modulů a modulů snap-in.

Ve výchozím nastavení se do relací importuje jenom modul Microsoft.PowerShell.Core, ale pokud nejsou rutiny vyloučené, můžete k přidání modulů a modulů a modulů snap-in do relace použít rutiny Import-Module a Add-PSSnapin.

Moduly zadané v této hodnotě parametru se importují kromě modulů zadaných v konfiguračním souboru relace (New-PSSessionConfigurationFile). Nastavení v konfiguračním souboru relace ale můžou skrýt příkazy exportované moduly nebo zabránit uživatelům v jejich používání.

Moduly zadané v této hodnotě parametru nahrazují seznam modulů zadaných parametrem ModulesToImport rutiny Register-PSSessionConfiguration.

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

Typ:

Object[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

NameParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
AssemblyNameParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

Určuje název konfigurace relace, kterou chcete změnit.

Tento parametr nelze použít ke změně názvu konfigurace relace.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-NoServiceRestart

Nerestartuje službu WinRM a potlačí výzvu k restartování služby.

Při spuštění Set-PSSessionConfigurationse ve výchozím nastavení zobrazí výzva k restartování služby WinRM, aby se nová konfigurace relace projevila. Dokud se služba WinRM nerestartuje, nová konfigurace relace není platná.

Pokud chcete restartovat službu WinRM bez výzvy, použijte parametr Force. Pokud chcete službu WinRM restartovat ručně, použijte rutinu Restart-Service.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Path

Určuje cestu konfiguračního souboru relace (.pssc), například cestu vytvořenou rutinou New-PSSessionConfigurationFile. Pokud tuto cestu vynecháte, výchozí je aktuální adresář.

Informace o tom, jak upravit konfigurační soubor relace, najdete v tématu nápovědy pro rutinu New-PSSessionConfigurationFile.

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SessionConfigurationFile
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-PSVersion

Určuje verzi PowerShellu v relacích, které používají tuto konfiguraci relace.

Hodnota tohoto parametru má přednost před hodnotou klíče PowerShellVersion v konfiguračním souboru relace.

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

Typ:Version
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Verze modulu PowerShell

Sady parametrů

NameParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
AssemblyNameParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-RunAsCredential

Určuje přihlašovací údaje pro příkazy v relaci. Ve výchozím nastavení se příkazy spouštějí s oprávněními aktuálního uživatele.

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

Typ:PSCredential
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SecurityDescriptorSddl

Určuje jiný řetězec jazyka SDDL (Security Descriptor Definition Language) pro konfiguraci.

Tento řetězec určuje oprávnění potřebná k použití nové konfigurace relace. Pokud chcete v relaci použít konfiguraci relace, musí mít uživatelé alespoň Execute(Invoke) oprávnění ke konfiguraci.

Pokud chcete pro konfiguraci použít výchozí popisovač zabezpečení, zadejte prázdný řetězec ("") nebo hodnotu $Null. Výchozí hodnotou je kořenový SDDL na jednotce WSMan:.

Pokud je popisovač zabezpečení složitý, zvažte místo tohoto parametru ShowSecurityDescriptorUI. Oba parametry nelze použít ve stejném příkazu.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SessionTypeOption

Určuje možnosti specifické pro typ konfigurace relace. Zadejte objekt možností typu relace, například objekt PSWorkflowExecutionOption objekt, který New-PSWorkflowExecutionOption rutina vrátí.

Možnosti relací, které používají konfiguraci relace, jsou určeny hodnotami možností relace a možnostmi konfigurace relace. Pokud není uvedeno, mají možnosti nastavené v relaci, například pomocí rutiny New-PSSessionOption, přednost před možnostmi nastavenými v konfiguraci relace. Hodnoty možností relace však nesmí překročit maximální hodnoty nastavené v konfiguraci relace.

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

Typ:PSSessionTypeOption
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

NameParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False
AssemblyNameParameterSet
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ShowSecurityDescriptorUI

Označuje, že tato rutina seznam vlastností, který vám pomůže vytvořit nový SDDL pro konfiguraci relace. Seznam vlastností se zobrazí po spuštění příkazu Set-PSSessionConfiguration a potom restartujte službu WinRM.

Při nastavování oprávnění ke konfiguraci nezapomeňte, že uživatelé musí mít alespoň Execute(Invoke) oprávnění k používání konfigurace relace v relaci.

Nelze použít parametr SecurityDescriptorSDDL a tento parametr ve stejném příkazu.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-StartupScript

Určuje spouštěcí skript pro konfiguraci. Zadejte plně kvalifikovanou cestu skriptu PowerShellu. Zadaný skript se spustí v nové relaci, která používá konfiguraci relace.

Pokud chcete odstranit spouštěcí skript z konfigurace relace, zadejte prázdný řetězec ("") nebo hodnotu $Null.

Spouštěcí skript můžete použít k další konfiguraci uživatelské relace. Pokud skript vygeneruje chybu, a to i neukončující chybu, relace se nevytvořila a příkaz New-PSSession selže.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ThreadApartmentState

Určuje stav apartmánu modulu threadingu, který se má použít. Přijatelné hodnoty jsou:

  • Unknown
  • MTA
  • STA

Vlastnosti parametru

Typ:ApartmentState
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-ThreadOptions

Určuje nastavení možností vlákna v konfiguraci. Toto nastavení definuje způsob vytváření vláken a použití při spuštění příkazu v relaci. Přijatelné hodnoty pro tento parametr jsou:

  • Default
  • ReuseThread
  • UseCurrentThread
  • UseNewThread

Výchozí hodnota je UseCurrentThread.

Další informace naleznete v tématu PSThreadOptions Výčtu.

Vlastnosti parametru

Typ:PSThreadOptions
Default value:None
Přípustné hodnoty:Default, UseNewThread, ReuseThread, UseCurrentThread
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-TransportOption

Určuje možnosti přenosu pro konfiguraci relace. Zadejte objekt možností přenosu, například objekt WSManConfigurationOption, který New-PSTransportOption rutina vrátí.

Možnosti relací, které používají konfiguraci relace, jsou určeny hodnotami možností relace a možnostmi konfigurace relace. Pokud není uvedeno, mají možnosti nastavené v relaci, například pomocí rutiny New-PSSessionOption, přednost před možnostmi nastavenými v konfiguraci relace. Hodnoty možností relace však nesmí překročit maximální hodnoty nastavené v konfiguraci relace.

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

Typ:PSTransportOption
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-UseSharedProcess

K hostování všech relací spuštěných stejným uživatelem použijte pouze jeden proces a použijte stejnou konfiguraci relace. Ve výchozím nastavení se každá relace hostuje ve vlastním procesu.

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

WSManConfigLeafElement

Poznámky

Tento cmdlet je dostupný pouze na platformách Windows.

Pokud chcete tuto rutinu spustit, spusťte PowerShell pomocí možnosti Spustit jako správce.

Rutina Set-PSSessionConfiguration nezmění název konfigurace a zprostředkovatel WSMan nepodporuje rutinu Rename-Item. Pokud chcete změnit název konfigurace relace, odstraňte konfiguraci pomocí rutiny Unregister-PSSessionConfiguration a pak pomocí rutiny Register-PSSessionConfiguration vytvořte a zaregistrujte novou konfiguraci relace.

Pomocí rutiny Set-PSSessionConfiguration můžete změnit výchozí konfigurace Microsoft.PowerShell a Microsoft.PowerShell32 relací. Nejsou chráněny. Pokud se chcete vrátit k původní verzi výchozí konfigurace relace, pomocí rutiny Unregister-PSSessionConfiguration odstraňte výchozí konfiguraci relace a pak ji pomocí rutiny Enable-PSRemoting obnovte.

Vlastnosti objektu konfigurace relace se liší podle možností nastavených pro konfiguraci relace a hodnot těchto možností. Konfigurace relací, které používají konfigurační soubor relace, mají také další vlastnosti.

Pomocí příkazů na jednotce WSMan: můžete změnit vlastnosti konfigurací relací. Nelze však použít jednotku WSMan: v PowerShellu 2.0 ke změně vlastností konfigurace relace, které jsou zavedeny v PowerShellu 3.0, například OutputBufferingMode. Příkazy Windows PowerShellu 2.0 negenerují chybu, ale jsou neefektivní. Pokud chcete změnit vlastnosti zavedené v PowerShellu 3.0, použijte jednotku WSMan: v PowerShellu 3.0 nebo novějším.