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

Set-PSSessionConfiguration

  • Referencia
Modul:
Microsoft.PowerShell.Core

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

Syntax

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>]
Set-PSSessionConfiguration
   [-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>]
Set-PSSessionConfiguration
   [-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 Set-PSSessionConfiguration parancsmag módosítja a munkamenet-konfigurációk tulajdonságait a helyi számítógépen.

A Név paraméter használatával azonosíthatja a módosítani kívánt munkamenet-konfigurációt. 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 a megfelelő paraméter értékét $Null .

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 következő Elérési út paramétert Set-PSSessionConfiguration: . A munkamenet-konfigurációs fájlokról további információt a about_Session_Configuration_Files talál. A munkamenet-konfigurációs fájlok létrehozásáról és módosításáról a New-PSSessionConfigurationFile parancsmagban olvashat.

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 munkamenet-konfigurációt használ. A munkamenet-konfiguráció meghatározza a PSSession funkció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. A munkamenet-konfigurációkkal kapcsolatos további tudnivalókért tekintse meg az about_Session_Configuration_Files című témakört.

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 következőt Get-Help WSMan: .

Példák

1. példa: A szál lakásállapotának módosítása

PS C:\> Set-PSSessionConfiguration -Name "MaintenanceShell" -ThreadApartmentState STA

Ez a parancs sta-ra módosítja a MaintenanceShell-konfiguráció szállakás állapotát. A módosítás a WinRM szolgáltatás újraindításakor lép életbe.

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

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

Ez a példa a MaximumReceivedObjectSizeMB tulajdonság értékét növeli.20 Ez a parancs a WinRM szolgáltatás újraindítását is kéri. A módosítás nem lép érvénybe, amíg a WinRM szolgáltatás újra nem indul.

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ában lévő indítási szkriptet a következőre módosítjaMaintenance.ps1: . 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 folyamatüzemeltető (|) elküldi a parancs Format-Listeredményeit a listában szereplő konfigurációs objektum összes tulajdonságát megjelenítő parancsnak. Ezután a WSMan-szolgáltató használatával megtekintjük a MaintenanceShell-konfiguráció inicializálási paramétereit. Get-ChildItemlekéri a gyermekelemeket a MaintenanceShell beépülő modul InitializationParameters csomópontjában. A WSMan szolgáltatóval kapcsolatos további információkért írja be a következőt 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) Engedélyezett tulajdonságát állítja be a következőre False: .
  • 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 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 engedélyezi a Enable-PSRemoting számítógépen található összes munkamenet-konfigurációt, és engedélyezi a távelérést, a parancsmag pedig Disable-PSRemoting 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.

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.

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 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 egy munkamenet-konfigurációt meghatározó szerelvényfájl .dll fájlnevé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.

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

-ConfigurationTypeName

A AssemblyName paraméter szerelvényében definiált munkamenet-konfiguráció típusát adja meg. 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.

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 használja 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

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

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

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

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. A paraméter értéke figyelmen kívül lesz hagyva.

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 é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 ha a parancsmagok nincsenek kizárva, a Import-Module 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 modulokon kívül 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 Register-PSSessionConfiguration parancsmag ModulesToImport paraméterére.

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

Típus:String
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása: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 futtatáskor Set-PSSessionConfigurationa rendszer arra kéri, hogy indítsa újra a WinRM szolgáltatást az új munkamenet-konfiguráció hatékonyabbá tétele érdekében. A WinRM szolgáltatás újraindításáig az új munkamenet-konfiguráció nem érvényes.

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

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 a munkamenet-konfigurációs fájl (.psscpéldául a New-PSSessionConfigurationFile parancsmag által létrehozott) elérési útját. 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 parancsmag súgótémakörében New-PSSessionConfigurationFile olvashat.

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

-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ó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. Ha munkamenet-konfigurációt szeretne használni egy munkamenetben, 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 értéket $Null. Az alapértelmezett érték a meghajtó gyökér SDDL-je WSMan: .

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

Típus:String
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 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

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, majd a WinRM szolgáltatás újraindítása után jelenik meg.

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

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 értéket $Null.

A felhasználói munkamenet további konfigurálásához használhat indítási szkriptet. Ha a szkript hibát okoz, még egy 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:

  • Unknown
  • 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 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 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

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

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.

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

WSManConfigLeafElement

Jegyzetek

A parancsmag futtatásához indítsa el a PowerShellt a Futtatás rendszergazdaként lehetőséggel.

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 parancsmag használatával 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 a 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 meghajtó parancsaival WSMan: módosíthatja a munkamenet-konfigurációk tulajdonságait. A PowerShell 2.0-ban azonban nem használhatja a WSMan: meghajtót a PowerShell 3.0-ban bevezetett munkamenet-konfigurációs tulajdonságok, például az OutputBufferingMode módosításához. 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 meghajtót a WSMan: PowerShell 3.0-s vagy újabb verziójában.