Megosztás a következőn keresztül:

Register-PSSessionConfiguration

  • Referencia
Modul:
Microsoft.PowerShell.Core

Új munkamenet-konfigurációt hoz létre és regisztrál.

Syntax

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

Description

A Register-PSSessionConfiguration parancsmag létrehoz és regisztrál egy új munkamenet-konfigurációt a helyi számítógépen. Ez egy speciális parancsmag, amellyel egyéni munkameneteket hozhat létre távoli felhasználók számára.

Minden PowerShell-munkamenet (PSSession) egy munkamenet-konfigurációt használ, más néven végpontot. Amikor a felhasználók létrehoznak egy munkamenetet, amely csatlakozik a számítógéphez, kiválaszthatják a munkamenet-konfigurációt, vagy használhatják a PowerShell-újraküldés engedélyezésekor regisztrált alapértelmezett munkamenet-konfigurációt. A felhasználók beállíthatják a $PSSessionConfigurationName beállítási változót is, amely az aktuális munkamenetben létrehozott távoli munkamenetek alapértelmezett konfigurációját adja meg.

A munkamenet-konfiguráció határozza meg a távoli munkamenet környezetét. A konfiguráció meghatározhatja, hogy mely parancsok és nyelvi elemek érhetők el a munkamenetben, és olyan beállításokat is tartalmazhat, amelyek védik a számítógépet, például olyan beállításokat, amelyek korlátozzák a munkamenet által távolról fogadott adatok mennyiségét egyetlen objektumban vagy parancsban. A munkamenet-konfiguráció biztonsági leírója határozza meg, hogy mely felhasználók jogosultak a munkamenet-konfiguráció használatára.

A konfiguráció elemeit egy új konfigurációs osztályt implementáló szerelvény és a munkamenetben futó szkript használatával határozhatja meg. A PowerShell 3.0-tól kezdve egy munkamenet-konfigurációs fájllal is meghatározhatja a munkamenet-konfigurációt.

A munkamenet-konfigurációkkal kapcsolatos információkért lásd: about_Session_Configurations. A munkamenet-konfigurációs fájlokról további információt a about_Session_Configuration_Files talál.

Példák

1. példa: NewShell-munkamenet-konfiguráció regisztrálása

Ebben a példában regisztráljuk a NewShell-munkamenet konfigurációját. A AssemblyName és az ApplicationBase paraméterek határozzák meg a MyShell.dll fájl helyét, amely meghatározza a munkamenet-konfiguráció parancsmagjait és szolgáltatóit. A ConfigurationTypeName paraméter megadja a szerelvényből használni kívánt konfigurációs osztályt.

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

A konfiguráció használatához írja be a következőt New-PSSession -ConfigurationName newshell: .

2. példa: MaintenanceShell-munkamenet-konfiguráció regisztrálása

Ez a példa regisztrálja a MaintenanceShell-munkamenet konfigurációját a helyi számítógépen. A StartupScript paraméter határozza meg a szkriptet Maintenance.ps1 .

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

Amikor egy felhasználó parancsot New-PSSession használ, és kiválasztja a MaintenanceShell-konfigurációt , a Maintenance.ps1 szkript az új munkamenetben fut. A szkript konfigurálhatja a munkamenetet. Ez magában foglalja a modulok importálását és a munkamenet végrehajtási szabályzatának beállítását. Ha a szkript bármilyen hibát generál, beleértve a nem megszüntetési hibákat is, a New-PSSession parancs meghiúsul.

3. példa: Munkamenet-konfiguráció regisztrálása

Ez a példa regisztrálja az AdminShell-munkamenet konfigurációját.

A $sessionParams változó egy kivonatoló, amely az összes paraméterértéket tartalmazza. Ezt a kivonatolót a rendszer PowerShell-splatting használatával továbbítja a parancsmagnak. A Register-PSSessionConfiguration parancs a SecurityDescritorSDDL paraméter használatával adja meg az SDDL értékét a $sddl változó értékében, és a MaximumReceivedObjectSizeMB paramétert az objektum méretkorlátjának növeléséhez. Emellett a StartupScript paramétert használja a munkamenetet konfiguráló szkript megadásához.

$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

4. példa: Konfigurációs tárolóelem visszaadása

Ez a példa bemutatja, hogyan regisztrálhatja a MaintenanceShell-konfigurációt . Register-PSSessionConfigurationA változóban $s tárolt WSManConfigContainerElement objektumot adja vissza. Format-List megjeleníti a visszaadott objektum összes tulajdonságát. A PSPath tulajdonság azt mutatja, hogy az objektum a WSMan: meghajtó könyvtárában van tárolva. Get-ChildItem (alias dir) megjeleníti az elérési út elemeit WSMan:\LocalHost\PlugIn . Ezek közé tartozik az új MaintenanceShell-konfiguráció és a PowerShellhez kapcsolódó két alapértelmezett konfiguráció.

$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}

5. példa: Munkamenet-konfiguráció regisztrálása indítási szkripttel

Ebben a példában létrehozzuk és regisztráljuk a WithProfile munkamenetkonfigurációt. A StartupScript paraméter arra utasítja a PowerShellt, hogy futtassa a megadott szkriptet a munkamenet-konfigurációt használó munkamenetekhez.

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

A szkript egyetlen parancsot tartalmaz, amely pontfeltárással futtatja a felhasználó CurrentUserAllHosts-profilját a munkamenet aktuális hatókörében.

További információ a profilokról: about_Profiles. A pontbehajtással kapcsolatos további információkért lásd : about_Scopes.

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:

  • Letiltva. Letiltja a munkamenet-konfigurációt. A számítógép távoli vagy helyi elérésére nem használható.
  • Helyi. Lehetővé teszi a helyi számítógép felhasználói számára, hogy a munkamenet-konfiguráció használatával helyi visszacsatolási munkamenetet hozzanak létre ugyanazon a számítógépen, de letiltják a hozzáférést a távoli felhasználók számára.
  • Távoli. Lehetővé teszi a helyi és távoli felhasználók számára, hogy a munkamenet-konfiguráció használatával munkameneteket hozzanak létre, és parancsokat futtasson ezen a számítógépen.

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

Más parancsmagok később felülbírálhatják ennek a paraméternek az értékét. A parancsmag például lehetővé teszi az Enable-PSRemoting összes munkamenet-konfiguráció távoli elérését, a parancsmag engedélyezi a Enable-PSSessionConfiguration munkamenet-konfigurációkat, a parancsmag pedig megakadályozza az Disable-PSRemoting összes munkamenet-konfiguráció távoli elérését.

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

Típus:PSSessionConfigurationAccessMode
Elfogadott értékek:Disabled, Local, Remote
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ApplicationBase

A AssemblyName paraméter értékében megadott szerelvényfájl (*.dll) elérési útját adja meg. Ezt a paramétert akkor használja, ha a AssemblyName paraméter értéke nem tartalmaz elérési utat. Az alapértelmezett az aktuális könyvtár.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-AssemblyName

Megadja annak a szerelvényfájlnak (*.dll) a nevét, amelyben a konfigurációtípus definiálva van. Ebben a paraméterben vagy az ApplicationBase paraméter értékében megadhatja a .dll elérési útját.

Ez a paraméter a ConfigurationTypeName paraméter megadásakor szükséges.

Típus:String
Position:1
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ConfigurationTypeName

Megadja az ehhez a konfigurációhoz használt Microsoft .NET-keretrendszer típus teljes nevét. A megadott típusnak implementálnia kell a System.Management.Automation.Remoting.PSSessionConfiguration osztályt .

A konfigurációtípust megvalósító szerelvényfájl (*.dll) megadásához adja meg a AssemblyName és az ApplicationBase paramétereket.

Egy típus létrehozásával szabályozhatja a munkamenet-konfiguráció több aspektusát, például a parancsmagok bizonyos paramétereinek felfedését vagy elrejtését, vagy olyan adatméret- és objektumméretkorlátok beállítását, amelyeket a felhasználók nem bírálhatnak felül.

Ha kihagyja ezt a paramétert, a Rendszer a DefaultRemotePowerShellConfiguration osztályt használja a munkamenet-konfigurációhoz.

Típus:String
Position:2
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliasok:cf
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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 adja meg a NoServiceRestart paramétert.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaximumReceivedDataSizePerCommandMB

Meghatározza, 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 50 MB.

Ha a ConfigurationTypeName paraméterben megadott konfigurációtípusban adatméretkorlát van meghatározva, a rendszer a konfigurációtípus korlátját használja, és a paraméter értékét figyelmen kívül hagyja.

Típus:Nullable<T>[Double]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-MaximumReceivedObjectSizeMB

Megadja, 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 10 MB.

Ha a ConfigurationTypeName paraméterben megadott konfigurációtípusban objektumméretkorlát van meghatározva, a rendszer a konfigurációtípus korlátját használja, és a paraméter értékét figyelmen kívül hagyja.

Típus:Nullable<T>[Double]
Position:Named
Alapértelmezett érték:10
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ModulesToImport

Megadja azokat a modulokat, amelyeket a rendszer automatikusan importál a munkamenet-konfigurációt használó munkamenetekbe.

Alapértelmezés szerint csak a Microsoft.PowerShell.Core importálódik munkamenetekbe. Hacsak a parancsmagok nincsenek kizárva, modulokat adhat Import-Module hozzá a munkamenethez.

Az ebben a paraméterértékben megadott modulok a SessionType paraméter által meghatározott és a munkamenet-konfigurációs fájlban (New-PSSessionConfigurationFile) szereplő ModulesToImport kulcsban felsorolt modulokon kívül importálódnak. 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.

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

Típus:Object[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Name

Megadja a munkamenet-konfiguráció nevét. Ez a paraméter kötelező.

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-NoServiceRestart

Ennek a paraméternek a célja a WinRM szolgáltatás újraindításának megakadályozása. Ez a funkció nincs implementálva.

Ez a funkció a PowerShell 7.5.0-preview.4-ben lett implementálva, de a módosítást nem tervezi visszahordani a Windows PowerShell 5.1-be.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Path

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

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

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ProcessorArchitecture

Meghatározza, hogy a PowerShell-folyamat 32 bites vagy 64 bites verziója elindul-e a munkamenet-konfigurációt használó munkamenetekben. A paraméter elfogadható értékei a következők: x86 (32 bites) és AMD64 (64 bites). Az alapértelmezett értéket a munkamenet-konfigurációt üzemeltető számítógép processzorarchitektúrája határozza meg.

Ezzel a paraméterrel 32 bites munkamenetet hozhat létre egy 64 bites számítógépen. Sikertelen 64 bites folyamat létrehozása 32 bites számítógépen.

Típus:String
Aliasok:PA
Elfogadott értékek:x86, amd64
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-PSVersion

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

Ennek a paraméternek az értéke elsőbbséget élvez a munkamenet-konfigurációs fájlBan található PowerShellVersion kulcs értékével szemben.

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

Típus:Version
Aliasok:PowerShellVersion
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:PSCredential
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SecurityDescriptorSddl

A konfiguráció biztonsági leíró definíciós nyelvének (SDDL) sztringjét adja meg.

Ez a sztring határozza meg az új munkamenet-konfiguráció használatához szükséges engedélyeket. Ha munkamenet-konfigurációt szeretne használni egy munkamenetben, a felhasználóknak legalább végrehajtási (meghívási) engedéllyel kell rendelkezniük a konfigurációhoz.

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

Ha kihagyja ezt a paramétert, a rendszer a WinRM szolgáltatás gyökér SDDL-jét használja ehhez a konfigurációhoz. A gyökér SDDL megtekintéséhez vagy módosításához használja a WSMan-szolgáltatót. Például: Get-Item wsman:\localhost\service\rootSDDL. A WSMan szolgáltatóval kapcsolatos további információkért írja be a következőt Get-Help wsman: .

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SessionType

Megadja a munkamenet-konfigurációval létrehozott munkamenet típusát. A paraméter elfogadható értékei a következők:

  • Üres. Alapértelmezés szerint nincsenek modulok hozzáadva a munkamenethez. A parancsmag paramétereivel modulokat, függvényeket, szkripteket és egyéb funkciókat adhat hozzá a munkamenethez.
  • Default (Alapértelmezett): Hozzáadja a Microsoft.PowerShell.Core-t a munkamenethez. Ez a modul tartalmazza azt a parancsmagot, amelyet a Import-Module felhasználók más modulok importálására használhatnak, hacsak ön nem tiltja kifejezetten a parancsmagot.
  • RestrictedRemoteServer. Csak a következő parancsmagokat tartalmazza: Exit-PSSession, Get-Command, , Get-FormatDataGet-Help, Measure-Object, Out-Defaultés Select-Object. A munkamenet-konfigurációs fájlban található szkriptek, szerelvények vagy kulcsok használatával modulokat, függvényeket, szkripteket és egyéb funkciókat adhat hozzá a munkamenethez.

Az alapértelmezett érték az Alapértelmezett érték.

Ennek a paraméternek az értéke elsőbbséget élvez a Munkamenet-konfigurációs fájl SessionType kulcsának értékével szemben.

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

Típus:PSSessionType
Elfogadott értékek:DefaultRemoteShell, Workflow
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-SessionTypeOption

Típusspecifikus beállításokat ad meg a munkamenet-konfigurációhoz. Adjon meg egy munkamenettípus-beállítási objektumot, például azt 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 használatával, 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.

Típus:PSSessionTypeOption
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ShowSecurityDescriptorUI

Azt jelzi, hogy ez a parancsmag megjelenít egy tulajdonságlapot, amely segít létrehozni az SDDL-t a munkamenet-konfigurációhoz. A tulajdonságlap a Register-PSSessionConfiguration parancs megadása után, majd a WinRM szolgáltatás újraindítása után jelenik meg.

A konfiguráció engedélyeinek beállításakor ne feledje, hogy a felhasználóknak legalább végrehajtási (meghívási) engedéllyel kell rendelkezniük a munkamenet-konfiguráció használatához egy munkamenetben.

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

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-StartupScript

Egy PowerShell-szkript teljes elérési útját adja meg. A megadott szkript a munkamenet-konfigurációt használó új munkamenetben fut.

A szkripttel emellett konfigurálhatja a munkamenetet. 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.

Típus:String
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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:

  • Ismeretlen
  • MTA
  • STA
Típus:ApartmentState
Elfogadott értékek:STA, MTA, Unknown
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-ThreadOptions

Megadja, hogyan jönnek létre és használhatók a szálak, amikor egy parancs fut a munkamenetben. A paraméter elfogadható értékei a következők:

  • Alapértelmezett
  • ReuseThread
  • UseCurrentThread
  • UseNewThread

Az alapértelmezett érték a UseCurrentThread.

További információ: PSThreadOptions Enumeration.

Típus:PSThreadOptions
Elfogadott értékek:Default, UseNewThread, ReuseThread, UseCurrentThread
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-TransportOption

Az átviteli lehetőséget adja meg.

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

Típus:PSTransportOption
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliasok:wi
Position:Named
Alapértelmezett érték:False
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

WSManConfigContainerElement

Jegyzetek

A parancsmag futtatásához a PowerShellt a Futtatás rendszergazdaként lehetőséggel kell elindítania.

Ez a parancsmag létrehoz egy XML-t, amely egy Web Services for Management (WS-Management) beépülő modul konfigurációját jelöli, és elküldi az XML-t a WS-Managementnek, amely regisztrálja a beépülő modult a helyi számítógépen (New-Item wsman:\localhost\plugin).

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.