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

Register-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

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

Syntax

NameParameterSet (Alapértelmezett) 

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

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

Register-PSSessionConfiguration
    [-Name] <String>
    -Path <String>
    [-ProcessorArchitecture <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 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, más néven végpontot használ. 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ókról további információért lásd a about_Session_Configurations. További információ a munkamenet-konfigurációs fájlokról: about_Session_Configuration_Files.

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 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 határozza meg 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 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 Maintenance.ps1 szkriptet.

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

Amikor egy felhasználó egy New-PSSession parancsot használ, és kiválasztja a MaintenanceShell konfigurációjá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 a 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-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 is 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óját. Register-PSSessionConfiguration egy WSManConfigContainerElement objektumot ad vissza, amely a $s változóban van tárolva. 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) a WSMan:\LocalHost\PlugIn elérési út elemeit jeleníti meg. Ezek közé tartozik az új MaintenanceShell konfiguráció, valamint 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 munkamenet-konfigurációját. A StartupScript paraméter arra utasítja a PowerShellt, hogy futtassa a megadott szkriptet minden olyan munkamenethez, amely a munkamenet-konfigurációt használja.

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

A szkript egyetlen parancsot tartalmaz, amely pont-forrás használatával 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:

  • Fogyatékos. 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 Enable-PSRemoting parancsmag például lehetővé teszi az összes munkamenet-konfiguráció távoli elérését, a Enable-PSSessionConfiguration parancsmag engedélyezi a munkamenet-konfigurációkat, a Disable-PSRemoting parancsmag pedig megakadályozza az összes munkamenet-konfiguráció távelérését.

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. Akkor használja ezt a paramétert, ha a AssemblyName paraméter értéke nem tartalmaz elérési utat. Az alapértelmezett az aktuális könyvtár.

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 annak a szerelvényfájlnak (*.dll) a nevét, amelyben a konfigurációtípus definiálva van. Ebben a paraméterben vagy a 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.

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 az ehhez a konfigurációhoz használt Microsoft .NET-keretrendszertí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 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álnak felül.

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

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 adja meg 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

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 megadva, a rendszer a konfigurációtípus korlátját használja, és a paraméter értékét figyelmen kívül hagyja.

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

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 az objektumméretkorlát a ConfigurationTypeName paraméterben megadott konfigurációtípusban 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.

Paramétertulajdonságok

Típus:

Nullable<T>[Double]

Alapértelmezett érték:10
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, amelyeket a rendszer automatikusan importál a munkamenet-konfigurációt használó munkamenetekbe.

Alapértelmezés szerint csak a Microsoft.PowerShell.Core importálja a munkamenetekbe. Hacsak a parancsmagok nincsenek kizárva, a Import-Module használatával modulokat adhat hozzá a munkamenethez.

Az ebben a paraméterértékben megadott modulok a SessionType paraméter által meghatározott modulokon kívül, valamint a munkamenet-konfigurációs fájl () New-PSSessionConfigurationFile kulcsában felsorolt modulokon kívül kerülnek importálásra. 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.

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 munkamenet-konfiguráció nevét. Ez a paraméter kötelező.

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.

Ha egy Register-PSSessionConfiguration parancsot futtat, a rendszer alapértelmezés szerint arra kéri, hogy indítsa újra a WinRM szolgáltatást az új munkamenet-konfiguráció hatékonyabbá 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, adja meg 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 egy munkamenet-konfigurációs fájl (.pssc) elérési útját és fájlnevét, például az New-PSSessionConfigurationFileáltal lé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.

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

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Elfogadott értékek:x86, amd64
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:PA

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

-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ó 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, használja a ShowSecurityDescriptorUI paramétert 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 Get-Help wsman.

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

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

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 jelenik meg, majd indítsa újra a WinRM szolgáltatást.

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.

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

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.

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:

  • Ismeretlen
  • 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, 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
  • Újrafelhasználási szál
  • UseCurrentThread
  • HasználatNewThread

Az alapértelmezett érték 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

Az átviteli lehetőséget adja meg.

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

WSManConfigContainerElement

Jegyzetek

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

A parancsmag futtatásához a PowerShellt a Futtatás rendszergazdaként beállítással 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.