Sdílet prostřednictvím

Register-PSSessionConfiguration

Modul:
Microsoft.PowerShell.Core Module

Vytvoří a zaregistruje novou konfiguraci relace.

Syntax

NameParameterSet (Výchozí) 

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

Rutina Register-PSSessionConfiguration vytvoří a zaregistruje novou konfiguraci relace v místním počítači. Jedná se o pokročilou rutinu, kterou můžete použít k vytváření vlastních relací pro vzdálené uživatele.

Každá relace PowerShellu (PSSession) používá konfiguraci relace, označovanou také jako koncový bod. Když uživatelé vytvoří relaci, která se připojí k počítači, můžou vybrat konfiguraci relace nebo použít výchozí konfiguraci relace zaregistrovanou při povolení vzdálené komunikace PowerShellu. Uživatelé mohou také nastavit proměnnou předvoleb $PSSessionConfigurationName, která určuje výchozí konfiguraci vzdálených relací vytvořených v aktuální relaci.

Konfigurace relace definuje prostředí pro vzdálenou relaci. Konfigurace může určit, které příkazy a jazykové prvky jsou v relaci k dispozici, a může obsahovat nastavení, která chrání počítač, například ty, které omezují množství dat, které relace může vzdáleně přijímat v jednom objektu nebo příkazu. Popisovač zabezpečení konfigurace relace určuje, kteří uživatelé mají oprávnění používat konfiguraci relace.

Prvky konfigurace můžete definovat pomocí sestavení, které implementuje novou třídu konfigurace a pomocí skriptu, který se spouští v relaci. Počínaje PowerShellem 3.0 můžete také definovat konfiguraci relace pomocí konfiguračního souboru relace.

Informace o konfiguracích relací najdete v tématu about_Session_Configurations. Informace o souborech konfigurace relací najdete v tématu about_Session_Configuration_Files.

Příklady

Příklad 1: Registrace konfigurace nové relace ProstředíShell

V tomto příkladu zaregistrujeme konfiguraci relace NewShellu. Parametry AssemblyName a ApplicationBase určují umístění souboru MyShell.dll, který určuje rutiny a zprostředkovatele v konfiguraci relace. Parametr ConfigurationTypeName určuje třídu konfigurace, která se má použít ze sestavení.

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

Chcete-li použít tuto konfiguraci, zadejte New-PSSession -ConfigurationName newshell.

Příklad 2: Registrace konfigurace relace MaintenanceShellu

Tento příklad zaregistruje konfiguraci relace MaintenanceShellu v místním počítači. Parametr startupscriptu určuje skript.

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

Když uživatel použije příkaz a vybere konfiguraci MaintenanceShellu, spustí se v nové relaci skript . Skript může nakonfigurovat relaci. To zahrnuje import modulů a nastavení zásad spouštění pro relaci. Pokud skript vygeneruje nějaké chyby, včetně neukončovaných chyb, příkaz New-PSSession selže.

Příklad 3: Registrace konfigurace relace

Tento příklad zaregistruje konfiguraci relace AdminShellu.

Proměnná $sessionParams je hashtable obsahující všechny hodnoty parametrů. Tato hashovatelná tabulka se předává rutině pomocí splattingu PowerShellu. Příkaz Register-PSSessionConfiguration pomocí parametru SecurityDescritorSDDL určuje SDDL v hodnotě proměnné $sddl a parametr MaximumReceivedObjectSizeMB parametru zvětšení limitu velikosti objektu. Používá také parametr StartupScript k určení skriptu, který konfiguruje relaci.

$sddl = "O:NSG:BAD:P(A;;GA;;;BA)S:P(AU;FA;GA;;;WD)(AU;FA;SA;GWGX;;WD)"
$sessionParams = @{
    Name="AdminShell"
    SecurityDescriptorSDDL=$sddl
    MaximumReceivedObjectSizeMB=20
    StartupScript="C:\scripts\AdminShell.ps1"
}
Register-PSSessionConfiguration @sessionParams

Příklad 4: Vrácení elementu kontejneru konfigurace

Tento příklad ukazuje, jak zaregistrovat konfiguraci MaintenanceShellu. Register-PSSessionConfiguration vrátí objekt WSManConfigContainerElement uložený v proměnné $s. Format-List zobrazí všechny vlastnosti vráceného objektu. Vlastnost PSPath ukazuje, že objekt je uložen v adresáři jednotky WSMan: Get-ChildItem (alias dir) zobrazí položky v cestě WSMan:\LocalHost\PlugIn. Patří mezi ně nová konfigurace MaintenanceShellu a dvě výchozí konfigurace, které jsou součástí PowerShellu.

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

Příklad 5: Registrace konfigurace relace pomocí spouštěcího skriptu

V tomto příkladu vytvoříme a zaregistrujeme konfiguraci relace WithProfile. Parametr StartupScript přesměruje PowerShell tak, aby spustil zadaný skript pro libovolnou relaci, která používá konfiguraci relace.

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

Skript obsahuje jeden příkaz, který používá dot sourcing ke spuštění uživatele CurrentUserAllHosts profilu v aktuálním oboru relace.

Další informace o profilech, viz about_Profiles. Další informace o dot sourcing naleznete v tématu about_Scopes.

Parametry

-AccessMode

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

  • Invalidní. Zakáže konfiguraci relace. Nelze jej použít pro vzdálený nebo místní přístup k počítači.
  • Místní. Umožňuje uživatelům místního počítače použít konfiguraci relace k vytvoření relace zpětné smyčky na stejném počítači, ale odepře přístup vzdáleným uživatelům.
  • Vzdálený. Umožňuje místním a vzdáleným uživatelům používat konfiguraci relace k vytváření relací a spouštění příkazů na tomto počítači.

Výchozí hodnota je Remote.

Další rutiny mohou později přepsat hodnotu tohoto parametru. Například rutina Enable-PSRemoting umožňuje vzdálený přístup ke všem konfiguracím relací, rutina Enable-PSSessionConfiguration povoluje konfigurace relací a rutina Disable-PSRemoting brání vzdálenému přístupu ke všem konfiguracím relací.

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

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

Sady parametrů

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

-ApplicationBase

Určuje cestu k souboru sestavení (*.dll), který je zadán v hodnotě parametru AssemblyName. Tento parametr použijte, pokud hodnota AssemblyName parametr neobsahuje cestu. Výchozí hodnota je aktuální adresář.

Vlastnosti parametru

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

Sady parametrů

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

-AssemblyName

Určuje název souboru sestavení (*.dll), ve kterém je definován typ konfigurace. Cestu .dll můžete zadat v tomto parametru nebo v hodnotě ApplicationBase parametru.

Tento parametr se vyžaduje, když zadáte parametr ConfigurationTypeName.

Vlastnosti parametru

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

Sady parametrů

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

-ConfigurationTypeName

Určuje plně kvalifikovaný název typu rozhraní Microsoft .NET Framework, který se používá pro tuto konfiguraci. Zadaný typ musí implementovat System.Management.Automation.Remoting.PSSessionConfiguration třídy.

Chcete-li zadat soubor sestavení (*.dll), který implementuje typ konfigurace, zadejte AssemblyName a ApplicationBase parametry.

Vytvoření typu umožňuje řídit více aspektů konfigurace relace, jako je zveřejnění nebo skrytí určitých parametrů rutin nebo nastavení omezení velikosti dat a velikosti objektu, které uživatelé nemohou přepsat.

Pokud tento parametr vynecháte, DefaultRemotePowerShellConfiguration třída se použije pro konfiguraci relace.

Vlastnosti parametru

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

Sady parametrů

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

-Confirm

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

Vlastnosti parametru

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

Sady parametrů

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

-Force

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

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

Vlastnosti parametru

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

Sady parametrů

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

-MaximumReceivedDataSizePerCommandMB

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

Pokud je omezení velikosti dat definováno v typu konfigurace zadaném v parametru ConfigurationTypeName, použije se limit typu konfigurace a hodnota tohoto parametru se ignoruje.

Vlastnosti parametru

Typ:Double
Default value:50
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

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

-MaximumReceivedObjectSizeMB

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

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

Vlastnosti parametru

Typ:Double
Default value:10
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

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

-ModulesToImport

Určuje moduly, které se automaticky importují do relací, které používají konfiguraci relace.

Ve výchozím nastavení se do relací importují jenom Microsoft.PowerShell.Core. Pokud nejsou rutiny vyloučené, můžete k přidání modulů do relace použít Import-Module.

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

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

Typ:

Object[]

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

Sady parametrů

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

-Name

Určuje název konfigurace relace. Tento parametr je povinný.

Vlastnosti parametru

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

Sady parametrů

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

-NoServiceRestart

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

Když spustíte příkaz Register-PSSessionConfiguration, zobrazí se ve výchozím nastavení výzva k restartování služby WinRM, aby se nová konfigurace relace projevila. Dokud se služba WinRM nerestartuje, nová konfigurace relace není platná.

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

Vlastnosti parametru

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

Sady parametrů

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

-Path

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

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

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

Sady parametrů

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

-ProcessorArchitecture

Určuje, jestli je v relacích, které používají tuto konfiguraci relace, spuštěna 32bitová nebo 64bitová verze procesu PowerShellu. Přijatelné hodnoty pro tento parametr jsou: x86 (32bitová verze) a AMD64 (64bitová verze). Výchozí hodnota je určena architekturou procesoru počítače, který hostuje konfiguraci relace.

Tento parametr můžete použít k vytvoření 32bitové relace na 64bitovém počítači. Pokusy o vytvoření 64bitového procesu na 32bitovém počítači selžou.

Vlastnosti parametru

Typ:String
Default value:None
Přípustné hodnoty:x86, amd64
Podporuje zástupné znaky:False
DontShow:False
Aliasy:PA

Sady parametrů

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

-PSVersion

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

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

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

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

Sady parametrů

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

-RunAsCredential

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

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

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

Sady parametrů

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

-SecurityDescriptorSddl

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

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

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

Pokud tento parametr vynecháte, použije se pro tuto konfiguraci kořenový SDDL pro službu WinRM. Pokud chcete zobrazit nebo změnit kořenový SDDL, použijte zprostředkovatele WSMan. Příklad: Get-Item wsman:\localhost\service\rootSDDL. Další informace o zprostředkovateli WSMan zadejte Get-Help wsman.

Vlastnosti parametru

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

Sady parametrů

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

-SessionType

Určuje typ relace, která se vytvoří pomocí konfigurace relace. Přijatelné hodnoty pro tento parametr jsou:

  • Prázdný. Do relace se ve výchozím nastavení nepřidávají žádné moduly. Pomocí parametrů této rutiny můžete do relace přidat moduly, funkce, skripty a další funkce.
  • Výchozí. Přidá do relace Microsoft.PowerShell.Core. Tento modul obsahuje rutinu Import-Module, kterou uživatelé můžou použít k importu dalších modulů, pokud tuto rutinu explicitně nezakážete.
  • Omezený vzdálený server. Zahrnuje pouze následující rutiny: Exit-PSSession, Get-Command, Get-FormatData, Get-Help, Measure-Object, Out-Defaulta Select-Object. Pomocí skriptu nebo sestavení nebo klíčů v konfiguračním souboru relace můžete do relace přidat moduly, funkce, skripty a další funkce.

Výchozí hodnota je Default.

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

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

Typ:PSSessionType
Default value:None
Přípustné hodnoty:DefaultRemoteShell, Workflow
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

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

-SessionTypeOption

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

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

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

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

Sady parametrů

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

-ShowSecurityDescriptorUI

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

Při nastavování oprávnění pro konfiguraci nezapomeňte, že uživatelé musí mít alespoň oprávnění Spustit (Vyvolat), aby mohli v relaci používat konfiguraci relace.

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

Vlastnosti parametru

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

Sady parametrů

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

-StartupScript

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

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

Vlastnosti parametru

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

Sady parametrů

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

-ThreadApartmentState

Určuje stav bytu vláken v relaci. Přijatelné hodnoty pro tento parametr jsou: STA, MTA a Unknown. Výchozí hodnota je Neznámá.

Vlastnosti parametru

Typ:ApartmentState
Default value:None
Přípustné hodnoty:STA, MTA, Unknown
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

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

-ThreadOptions

Určuje, jak se vlákna vytvářejí a používají při spuštění příkazu v relaci. Přijatelné hodnoty pro tento parametr jsou:

  • Výchozí
  • Znovu použítThread
  • PoužítProudové_vlákno
  • PoužítNewThread

Výchozí hodnota je UseCurrentThread.

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

Vlastnosti parametru

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

Sady parametrů

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

-TransportOption

Určuje možnost přenosu.

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

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

Sady parametrů

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

-UseSharedProcess

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

Tento parametr byl představen v PowerShellu 3.0.

Vlastnosti parametru

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

Sady parametrů

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

-WhatIf

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

Vlastnosti parametru

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

Sady parametrů

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

CommonParameters

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

Vstupy

None

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

Výstupy

WSManConfigContainerElement

Poznámky

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

Tato rutina generuje xml, který představuje konfiguraci modulu plug-in Správa webových služeb (WS-Management) a odešle xml do služby WS-Management, která zaregistruje modul plug-in v místním počítači (New-Item wsman:\localhost\plugin).

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