Set-PSSessionConfiguration

Modul:

Microsoft.PowerShell.Core Module

Egy regisztrált munkamenet-konfiguráció tulajdonságainak módosítása.

Syntax

NameParameterSet (Alapértelmezett)

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

Ez a parancsmag csak a Windows platformon érhető el.

A Set-PSSessionConfiguration parancsmag módosítja a munkamenet-konfigurációk tulajdonságait a helyi számítógépen.

A módosítani kívánt munkamenet-konfiguráció azonosításához használja a Név paramétert. A többi paraméter használatával adjon meg új értékeket a munkamenet-konfiguráció tulajdonságaihoz. Ha törölni szeretne egy tulajdonságértéket a konfigurációból, és az alapértelmezett értéket szeretné használni, adjon meg egy üres sztringet ("") vagy egy $Null értéket a megfelelő paraméterhez.

A PowerShell 3.0-tól kezdve munkamenetkonfigurációs fájllal definiálhat munkamenet-konfigurációt. Ez a funkció egy egyszerű és felderíthető módszert biztosít a munkamenet-konfigurációt használó munkamenetek tulajdonságainak beállításához és módosításához. Munkamenet-konfigurációs fájl megadásához használja a Set-PSSessionConfiguration paraméterét. További információ a munkamenet-konfigurációs fájlokról: about_Session_Configuration_Files. A munkamenet-konfigurációs fájlok létrehozásáról és módosításáról a New-PSSessionConfigurationFile parancsmagban talál további információt.

A munkamenet-konfigurációk határozzák meg a helyi számítógéphez csatlakozó távoli munkamenetek (PSSessions) környezetét. Minden PSSession egy munkamenet-konfigurációt használ. A munkamenet-konfiguráció meghatározza a PSSessionfunkcióit, például a munkamenetben elérhető modulokat, a futtatható parancsmagokat, a nyelvi módot, a kvótákat és az időtúllépéseket. A munkamenet-konfiguráció biztonsági leírója határozza meg, hogy ki csatlakozhat a helyi számítógéphez a munkamenet-konfigurációval. További információ a munkamenet-konfigurációkról: about_Session_Configurations.

A munkamenet-konfiguráció tulajdonságainak megtekintéséhez használja a Get-PSSessionConfiguration parancsmagot vagy a WSMan-szolgáltatót. A WSMan-szolgáltatóval kapcsolatos további információkért írja be a Get-Help WSMan.

Példák

1. példa: Munkamenet-konfiguráció létrehozása és módosítása

Ez a példa bemutatja, hogyan vehet fel és távolíthat el indítási szkripteket egy konfigurációból.

Az első parancs létrehozza a AdminShell konfigurációt. A második parancs hozzáadja a AdminConfig.ps1 szkriptet a konfigurációhoz. A módosítás a WinRMújraindításakor lép életbe. A harmadik parancs eltávolítja a AdminConfig.ps1 szkriptet a konfigurációból.

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

2. példa: Eredmények megjelenítése

Ez a példa növeli a MaximumReceivedObjectSizeMB tulajdonság értékét 20. Ez a parancs azt is kéri, hogy indítsa újra a WinRM szolgáltatást. A módosítás csak akkor lép érvénybe, ha a WinRM szolgáltatás újraindul.

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

3. példa: Eredmények megjelenítése különböző módokon

Ebben a példában Set-PSSessionConfiguration a MaintenanceShell munkamenet-konfigurációjának indítási szkriptje Maintenance.ps1változik. A kimenet megjeleníti a módosítást, és kéri, hogy indítsa újra a WinRM szolgáltatást. A válasz y (igen).

Get-PSSessionConfiguration lekéri a MaintenanceShell munkamenet-konfigurációját. A folyamatkezelő (|) elküldi a parancs eredményeit Format-List, amely megjeleníti a konfigurációs objektum összes tulajdonságát egy listában. Ezután a WSMan-szolgáltató használatával megtekintjük a MaintenanceShell konfiguráció inicializálási paramétereit. Get-ChildItem lekéri a gyermekelemeket a InitializationParameters csomópontban a MaintenanceShell beépülő modulhoz. A WSMan-szolgáltatóval kapcsolatos további információkért írja be a 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

Paraméterek

-AccessMode

Engedélyezi és letiltja a munkamenet-konfigurációt, és meghatározza, hogy használható-e távoli vagy helyi munkamenetekhez a számítógépen. A paraméter elfogadható értékei a következők:

• Disabled. Letiltja a munkamenet-konfigurációt. A számítógép távoli vagy helyi elérésére nem használható. Ez az érték a munkamenet-konfiguráció () WSMan:\<ComputerName>\PlugIn\<SessionConfigurationName>\Enabled tulajdonságát Falseértékre állítja.
• Local. Hozzáad egy Network_Deny_All bejegyzést a munkamenet-konfiguráció biztonsági leírójába. A helyi számítógép felhasználói a munkamenet-konfigurációval létrehozhatnak egy helyi visszacsatolási munkamenetet ugyanazon a számítógépen, de a távoli felhasználók hozzáférése megtagadva.
• Remote. Eltávolítja Deny_All és Network_Deny_All bejegyzéseket a munkamenet-konfiguráció biztonsági leíróiból. A helyi és távoli számítógépek felhasználói a munkamenet-konfigurációval munkameneteket hozhatnak létre, és parancsokat futtathatnak ezen a számítógépen.

Az alapértelmezett érték Távoli.

Más parancsmagok később felülbírálhatják ennek a paraméternek az értékét. A Enable-PSRemoting parancsmag például engedélyezi a számítógép összes munkamenet-konfigurációját, és lehetővé teszi a távelérést, és a Disable-PSRemoting parancsmag csak helyi hozzáférést biztosít a számítógépen található összes munkamenet-konfigurációhoz.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	PSSessionConfigurationAccessMode
Alapértelmezett érték:	None
Elfogadott értékek:	Disabled, Local, Remote
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ApplicationBase

Megadja a szerelvényfájl (*.dll) elérési útját, amely a AssemblyName paraméter értékében van megadva.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

NameParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

AssemblyNameParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-AssemblyName

Megadja a szerelvény nevét. Ez a parancsmag létrehoz egy munkamenet-konfigurációt egy szerelvényben definiált osztály alapján.

Adja meg a munkamenet-konfigurációt meghatározó szerelvény .dll fájl nevét vagy teljes elérési útját. Ha csak a fájlnevet adja meg, az elérési utat az ApplicationBase paraméter értékében adhatja meg.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

AssemblyNameParameterSet

Position:	1
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ConfigurationTypeName

Megadja a szerelvényben a AssemblyName paraméterben definiált munkamenet-konfiguráció típusát. A megadott típusnak implementálnia kell a System.Management.Automation.Remoting.PSSessionConfiguration osztályt.

Erre a paraméterre akkor van szükség, ha szerelvénynevet ad meg.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

AssemblyNameParameterSet

Position:	2
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cf

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Force

Letiltja az összes felhasználói kérést, és kérés nélkül újraindítja a WinRM szolgáltatást. A szolgáltatás újraindítása hatékonyabbá teszi a konfiguráció módosítását.

Az újraindítás megelőzéséhez és az újraindítási kérés letiltásához használja a NoServiceRestart paramétert.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-MaximumReceivedDataSizePerCommandMB

Megadja, hogy mennyi adat küldhető el a számítógépre egyetlen távoli parancsban. Adja meg az adatméretet megabájtban (MB). Az alapértelmezett érték a 50.

Ha a ConfigurationTypeName paraméterben megadott konfigurációtípusban adatméretkorlát van megadva, a rendszer a konfigurációtípus korlátját használja. A paraméter értéke figyelmen kívül lesz hagyva.

Paramétertulajdonságok

Típus:	Nullable<T>[Double]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-MaximumReceivedObjectSizeMB

Meghatározza, hogy mennyi adat küldhető a számítógépre egyetlen objektumban. Adja meg az adatméretet megabájtban. Az alapértelmezett érték a 10.

Ha a ConfigurationTypeName paraméterben megadott konfigurációtípusban objektumméretkorlát van megadva, a rendszer a konfigurációtípus korlátját használja. A paraméter értéke figyelmen kívül lesz hagyva.

Paramétertulajdonságok

Típus:	Nullable<T>[Double]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ModulesToImport

Megadja azokat a modulokat és beépülő modulokat, amelyeket a rendszer automatikusan importál a munkamenet-konfigurációt használó munkamenetekbe. Adja meg a modult és a beépülő modulneveket.

Alapértelmezés szerint csak a Microsoft.PowerShell.Core modul lesz importálva a munkamenetekbe, de hacsak a parancsmagok nincsenek kizárva, a Import-Module és Add-PSSnapin parancsmagokkal modulokat és beépülő modulokat adhat hozzá a munkamenethez.

Az ebben a paraméterértékben megadott modulokat a rendszer a munkamenet-konfigurációs fájlban (New-PSSessionConfigurationFile) megadott modulok mellett importálja. A munkamenet-konfigurációs fájl beállításai azonban elrejthetik a modulok által exportált parancsokat, vagy megakadályozhatják, hogy a felhasználók használják őket.

Az ebben a paraméterértékben megadott modulok lecserélik a megadott modulok listáját a parancsmag Register-PSSessionConfiguration paraméterére.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	Object[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

NameParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

AssemblyNameParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Name

Megadja a módosítani kívánt munkamenet-konfiguráció nevét.

Ezzel a paraméternel nem módosíthatja a munkamenet-konfiguráció nevét.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-NoServiceRestart

Nem indítja újra a WinRM szolgáltatást, és letiltja a szolgáltatás újraindítására vonatkozó kérést.

Alapértelmezés szerint a Set-PSSessionConfigurationfuttatásakor a rendszer arra kéri, hogy indítsa újra a WinRM szolgáltatást az új munkamenet-konfiguráció hatékonysá tétele érdekében. Az WinRM szolgáltatás újraindításáig az új munkamenet-konfiguráció nem érvényes.

Ha a WinRM szolgáltatást kérés nélkül szeretné újraindítani, használja a Force paramétert. A WinRM szolgáltatás manuális újraindításához használja a Restart-Service parancsmagot.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Path

Megadja a munkamenet-konfigurációs fájl (.pssc) elérési útját, például a New-PSSessionConfigurationFile parancsmag által létrehozott fájlt. Ha kihagyja az elérési utat, az alapértelmezett az aktuális könyvtár.

A munkamenet-konfigurációs fájlok módosításáról a New-PSSessionConfigurationFile parancsmag súgótémakörében olvashat.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

SessionConfigurationFile

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PSVersion

A PowerShell ezen munkamenet-konfigurációt használó munkamenetekben való verzióját adja meg.

A paraméter értéke elsőbbséget élvez a PowerShellVersion kulcs értékével szemben a munkamenet-konfigurációs fájlban.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	Version
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	PowerShell-verzió

Paraméterkészletek

NameParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

AssemblyNameParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-RunAsCredential

Megadja a munkamenet parancsainak hitelesítő adatait. Alapértelmezés szerint a parancsok az aktuális felhasználó engedélyeivel futnak.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-SecurityDescriptorSddl

A konfigurációhoz egy másik biztonságileíró definíciós nyelv (SDDL) sztringet ad meg.

Ez a sztring határozza meg az új munkamenet-konfiguráció használatához szükséges engedélyeket. Munkamenet-konfiguráció használatához a felhasználóknak legalább Execute(Invoke) engedéllyel kell rendelkezniük a konfigurációhoz.

A konfiguráció alapértelmezett biztonsági leírójának használatához írjon be egy üres sztringet ("") vagy egy $Nullértéket. Az alapértelmezett érték a gyökér SDDL a WSMan: meghajtón.

Ha a biztonsági leíró összetett, fontolja meg a ShowSecurityDescriptorUI paraméter használatát. Nem használhatja mindkét paramétert ugyanabban a parancsban.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-SessionTypeOption

Típusspecifikus beállításokat ad meg a munkamenet-konfigurációhoz. Adjon meg egy munkamenettípus-beállításobjektumot, például a PSWorkflowExecutionOption objektumot, amelyet a New-PSWorkflowExecutionOption parancsmag visszaad.

A munkamenet-konfigurációt használó munkamenetek beállításait a munkamenet-beállítások és a munkamenet-konfigurációs beállítások értékei határozzák meg. Ha nincs megadva, a munkamenetben megadott beállítások, például a New-PSSessionOption parancsmag, elsőbbséget élveznek a munkamenet-konfigurációban megadott beállításokkal szemben. A munkamenet-beállítás értéke azonban nem haladhatja meg a munkamenet-konfigurációban beállított maximális értékeket.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	PSSessionTypeOption
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

NameParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

AssemblyNameParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ShowSecurityDescriptorUI

Ha ezt a paramétert használja, a parancsmag megnyit egy tulajdonságlapot, amely segít létrehozni egy új SDDL-t a munkamenet-konfigurációhoz. A tulajdonságlap a Set-PSSessionConfiguration parancs futtatása után jelenik meg, majd indítsa újra a WinRM szolgáltatást.

Amikor engedélyeket állít be a konfigurációhoz, ne feledje, hogy a felhasználóknak legalább Execute(Invoke) engedéllyel kell rendelkezniük a munkamenet-konfiguráció használatához.

Nem használhatja a SecurityDescriptorSDDL paramétert és ezt a paramétert ugyanabban a parancsban.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-StartupScript

A konfiguráció indítási szkriptjének megadása. Adja meg egy PowerShell-szkript teljes elérési útját. A megadott szkript a munkamenet-konfigurációt használó új munkamenetben fut.

Ha törölni szeretne egy indítási szkriptet egy munkamenet-konfigurációból, írjon be egy üres sztringet ("") vagy egy $Nullértéket.

A felhasználói munkamenet további konfigurálásához használhat indítási szkriptet. Ha a szkript hibát okoz, akár nem végződő hibát is, a munkamenet nem jön létre, és a New-PSSession parancs meghiúsul.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ThreadApartmentState

A használni kívánt menetelési modul lakásállapotát adja meg. Az elfogadható értékek a következők:

• Unknown
• MTA
• STA

Paramétertulajdonságok

Típus:	ApartmentState
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-ThreadOptions

Megadja a konfiguráció szálbeállításait. Ez a beállítás határozza meg, hogyan jönnek létre és használhatók a szálak egy parancs végrehajtásakor a munkamenetben. A paraméter elfogadható értékei a következők:

• Default
• ReuseThread
• UseCurrentThread
• UseNewThread

Az alapértelmezett érték a UseCurrentThread.

További információ: PSThreadOptions Enumeration.

Paramétertulajdonságok

Típus:	PSThreadOptions
Alapértelmezett érték:	None
Elfogadott értékek:	Default, UseNewThread, ReuseThread, UseCurrentThread
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-TransportOption

Megadja a munkamenet-konfiguráció átviteli beállításait. Adjon meg egy átviteli beállítások objektumot, például a WSManConfigurationOption objektumot, amelyet a New-PSTransportOption parancsmag ad vissza.

A munkamenet-konfigurációt használó munkamenetek beállításait a munkamenet-beállítások és a munkamenet-konfigurációs beállítások értékei határozzák meg. Ha nincs megadva, a munkamenetben megadott beállítások, például a New-PSSessionOption parancsmag, elsőbbséget élveznek a munkamenet-konfigurációban megadott beállításokkal szemben. A munkamenet-beállítás értéke azonban nem haladhatja meg a munkamenet-konfigurációban beállított maximális értékeket.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	PSTransportOption
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-UseSharedProcess

Csak egy folyamattal üzemeltetheti az összes munkamenetet, amelyet ugyanaz a felhasználó indított el, és ugyanazt a munkamenet-konfigurációt használja. Alapértelmezés szerint minden munkamenet a saját folyamatában van üzemeltetve.

Ezt a paramétert a PowerShell 3.0-ban vezettük be.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Wi

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

WSManConfigLeafElement

Jegyzetek

Ez a parancsmag csak Windows-platformokon érhető el.

A parancsmag futtatásához indítsa el a PowerShellt a Futtatás rendszergazdaként beállítással.

A Set-PSSessionConfiguration parancsmag nem módosítja a konfiguráció nevét, és a WSMan szolgáltató nem támogatja a Rename-Item parancsmagot. A munkamenet-konfiguráció nevének módosításához a Unregister-PSSessionConfiguration parancsmaggal törölje a konfigurációt, majd a Register-PSSessionConfiguration parancsmaggal hozzon létre és regisztráljon egy új munkamenet-konfigurációt.

A Set-PSSessionConfiguration parancsmaggal módosíthatja az alapértelmezett Microsoft.PowerShell és Microsoft.PowerShell32 munkamenet-konfigurációkat. Nem védettek. Ha vissza szeretne térni az alapértelmezett munkamenet-konfiguráció eredeti verziójára, a Unregister-PSSessionConfiguration parancsmaggal törölje az alapértelmezett munkamenet-konfigurációt, majd állítsa vissza a Enable-PSRemoting parancsmagot.

A munkamenet-konfigurációs objektumok tulajdonságai a munkamenet-konfiguráció beállításaitól és a beállítások értékétől függően változnak. Emellett a munkamenet-konfigurációs fájlt használó munkamenet-konfigurációk további tulajdonságokkal is rendelkeznek.

A WSMan: meghajtó parancsaival módosíthatja a munkamenet-konfigurációk tulajdonságait. A PowerShell 2.0 WSMan: meghajtóját azonban nem használhatja a PowerShell 3.0-ban bevezetett munkamenet-konfigurációs tulajdonságok módosításához, például OutputBufferingMode. A Windows PowerShell 2.0-parancsok nem okoznak hibát, de hatástalanok. A PowerShell 3.0-ban bevezetett tulajdonságok módosításához használja a WSMan: meghajtót a PowerShell 3.0-s vagy újabb verziójában.

Kapcsolódó hivatkozások

• PSSessionConfiguration letiltása
• PSSession konfiguráció engedélyezése
• Get-PSSessionConfiguration (PSSession konfiguráció lekérése)
• New-PSSessionConfigurationFile
• New-PSSessionOption
• New-PSTransportOption
• Register-PSSessionConfiguration
• Test-PSSessionConfigurationFile
• Unregister-PSSessionConfiguration
• WSMan-szolgáltató
• a munkamenet-konfigurációk_ról
• A munkamenet-konfigurációs fájlokról