Konzolfelület létrehozásaHow to Create a Console Shell

A Windows PowerShell egy "make-Kit" néven is ismert Make-shell eszközt biztosít, amely nem bővíthető konzol-rendszerhéj létrehozására szolgál.Windows PowerShell provides a Make-Shell tool, also referred to as the "make-kit", that is used to create a console shell that is not extensible. Az ezzel az új eszközzel létrehozott rendszerhéjak később nem bővíthetők a Windows PowerShell beépülő modullal.Shells created with this new tool cannot be extended later through a Windows PowerShell snap-in.

SyntaxSyntax

Itt látható a Make-shell futtatására szolgáló szintaxis a make-file utasításban.Here is the syntax used to run Make-Shell from within a make-file.

make-shell
  -out n.exe
  -namespace ns
  [ -lib libdirectory1[,libdirectory2,..] ]
  [ -reference ca1.dll[,ca2.dll,...] ]
  [ -formatdata fd1.format.ps1xml[,fd2.format.ps1xml,...] ]
  [ -typedata td1.type.ps1xml[,td2.type.ps1xml,...] ]
  [ -source c1.cs [,c2.cs,...] ]
  [ -authorizationmanager authorizationManagerType ]
  [ -win32icon i.ico ]
  [ -initscript p.ps1 ]
  [ -builtinscript s1.ps1[,s2.ps1,...] ]
  [ -resource resourcefile.txt ]
  [ -cscflags cscFlags ]
  [ -? | -help ]

ParaméterekParameters

Itt látható a Make-shell paramétereinek rövid leírása.Here is a brief description of the parameters of Make-Shell.

Figyelemfelhívás

A Make-shell nem támogatja a szerelvények UNC elérési útját.UNC paths to assemblies are not supported by Make-Shell.

ParaméterParameter LeírásDescription
-n.exe-out n.exe Kötelező.Required. A létrehozni kívánt rendszerhéj neve.The name of the shell to produce. Az elérési út a paraméter részeként van megadva.The path is specified as part of this parameter.

Ha nincs megadva, a Make-shell hozzáfűzi az ". exe" értéket ehhez az értékhez.Make-shell will append ".exe" to this value if it is not specified. Vigyázat: Ne hozzon létre a hivatkozott. dll fájllal megegyező nevű kimeneti fájlt.Caution: Do not create an output file with the same name as the referenced .dll file. Ha ezt kísérli meg, a Make-shell eszköz létrehoz egy azonos nevű. cs fájlt, amely felülírja a parancsmag forráskódját tartalmazó. cs fájlt.If you attempt this, the Make-Shell tool creates a .cs file with the same name, which will overwrite the .cs file that has your cmdlet source code.
-névtér NS-namespace ns Kötelező.Required. A make-Kit által generált és lefordítható származtatott System. Management. Automation. futási terek. Runspaceconfiguration osztályhoz használandó névtér.The namespace to use for the derived System.Management.Automation.Runspaces.Runspaceconfiguration class that the make-kit generates and compiles.
-lib libdirectory1 [, libdirectory2,..]-lib libdirectory1[,libdirectory2,..] A .NET-szerelvények számára keresett könyvtárak, beleértve a Windows PowerShell szerelvényeit, a paraméter által megadott szerelvényeket, a reference másik szerelvény által közvetve hivatkozott szerelvényeket és a .NET rendszer szerelvényeit.The directories that are searched for .NET assemblies, including the Windows PowerShell assemblies, assemblies specified by the reference parameter, assemblies indirectly referenced by another assembly, and the .NET system assemblies.
-Reference ca1.dll [, ca2.dll,...]-reference ca1.dll[,ca2.dll,...] A rendszerhéjba felvenni kívánt szerelvények vesszővel tagolt listája.A comma-separated list of the assemblies to include in the shell. Ezek a szerelvények tartalmazzák az összes parancsmag és szolgáltató szerelvényt, valamint azokat az erőforrás-szerelvényeket, amelyeket be kell tölteni.These assemblies includes all cmdlet and provider assemblies, as well as resource assemblies that should be loaded. Ha ez a paraméter nincs megadva, akkor a rendszer egy olyan rendszerhéjt állít elő, amely csak a Windows PowerShell által biztosított alapparancsmagokat és szolgáltatókat tartalmazza.If this parameter is not specified, then a shell is produced that contains only the core cmdlets and providers provided by Windows PowerShell.

A szerelvények teljes elérési úttal is megadhatók, ellenkező esetben a paraméterben megadott elérési út használatával lesznek megkeresve lib .The assemblies can be specified using their full path, otherwise they will be searched for using the path specified by the lib parameter.
-formatdata fd1.format.ps1XML [, fd2.format.ps1XML,...]-formatdata fd1.format.ps1xml[,fd2.format.ps1xml,...] A rendszerhéjba felvenni kívánt formátumú adatok vesszővel tagolt listája.A comma-separated list of format data to include in the shell. Ha ez a paraméter nincs megadva, akkor a rendszer egy olyan rendszerhéjt állít elő, amely csak a Windows PowerShell által megadott formátumú adatformátumot tartalmazza.If this parameter is not specified, then a shell is produced that contains only the format data provided by Windows PowerShell.
-typedata td1.type.ps1XML [, td2.type.ps1XML,...]-typedata td1.type.ps1xml[,td2.type.ps1xml,...] A rendszerhéjba felvenni kívánt típusú adatok vesszővel tagolt listája.A comma-separated list of type data to include in the shell. Ha ez a paraméter nincs megadva, akkor a rendszer egy olyan rendszerhéjt állít elő, amely csak a Windows PowerShell által megadott típusú adattípusokat tartalmazza.If this parameter is not specified, then a shell is produced that contains only the type data provided by Windows PowerShell.
– forrás c1.cs [, c2.cs,...]-source c1.cs [,c2.cs,...] A rendszerhéj-fejlesztő által biztosított fájl neve, amely a rendszerhéj létrehozásához szükséges forráskódot tartalmazza.The name of a file, provided by the shell developer, that contains any source code needed to build the shell.

A forráskód-fájl a következő forráskód bármelyikét tartalmazhatja:The source code file can contain any of the following source code:

– Az Engedélyezéskezelő implementációja, amely felülbírálja az alapértelmezett engedélyezési kezelőt.- The Authorization manager implementation that overrides the default authorization manager. (Ezt egy szerelvénybe is be lehet állítani.)(This could also be supplied compiled into an assembly.)
-Szerelvény-információs attribútumok deklarációi: például a AssemblyCompanyAttribute, a AssemblyCopyrightAttribute, a AssemblyFileVersionAttribute, a AssemblyInformationalVersionAttribute, a AssemblyProductAttribute és a AssemblyTrademarkAttribute.- Assembly informational attribute declarations: such as the AssemblyCompanyAttribute, AssemblyCopyrightAttribute, AssemblyFileVersionAttribute, AssemblyInformationalVersionAttribute, AssemblyProductAttribute, and AssemblyTrademarkAttribute.
-authorizationmanager authorizationManagerType-authorizationmanager authorizationManagerType Az Engedélyezéskezelő implementációját tartalmazó típus.The type that contains the authorization manager implementation. Ez a forráskódban definiálható, vagy összeállítható a (z reference ) paraméterrel megadott szerelvénybe.This can be defined in source code, or compiled into an assembly (specified by the reference parameter). Ha ez a paraméter nincs megadva, a rendszer az alapértelmezett Security Managert használja.If this parameter is not specified, the default security manager is used. Az értéknek a teljes típusú névnek kell lennie, beleértve a névtereket is.The value should be the full type name, including namespaces.
– win32icon i. ico-win32icon i.ico A rendszerhéjhoz tartozó. exe fájl ikonja.The icon for the .exe file for the shell. Ha nincs megadva, a rendszerhéj ikonja azt jelzi, hogy a c# Fordító tartalmaz (ha van ilyen).If not specified, then the shell will have the icon that the c# compiler includes (if any).
– initscript p.ps1-initscript p.ps1 A rendszerhéj indítási profilja.The startup profile for the shell. A fájl tartalmazza a "as-is"; a Make-shell nem végez érvényesség-ellenőrzést.The file is included "as-is"; no validity checking is done by Make-Shell.
-builtinscript s1.ps1 [, s2.ps1,...]-builtinscript s1.ps1[,s2.ps1,...] A rendszerhéj beépített parancsfájljainak listája.A list of built-in scripts for the shell. Ezeket a szkripteket a rendszer az elérési úton lévő parancsfájlok előtt észleli, és azok tartalma nem módosítható a rendszerhéj felépítése után.These scripts are discovered before scripts in the path, and their contents cannot be changed once the shell is built.

A fájlok a következők: "as-is"; a Make-shell nem végez érvényesség-ellenőrzést.The files are included "as-is"; no validity checking is done by Make-Shell.
– erőforrás-resourcefile.txt-resource resourcefile.txt A rendszerhéj Súgó és szalagcím erőforrásait tartalmazó. txt fájl.The .txt file containing help and banner resources for the shell. Az első erőforrás neve ShellHelp, és tartalmazza azt a szöveget, amely akkor jelenik meg, ha a rendszerhéj a paraméterrel van meghívva help .The first resource is named ShellHelp, and contains the text displayed if the shell is invoked with the help parameter. A második erőforrás neve ShellBanner, és tartalmazza az interaktív módban a rendszerhéj indításakor megjelenő szöveget és szerzői jogi információkat.The second resource is named ShellBanner, and it contains the text and copyright information displayed when the shell is launched in interactive mode.

Ha a paraméter nincs megadva, vagy ezek az erőforrások nem találhatók, akkor a rendszer általános súgót és szalagcímet használ.If this parameter is not provided, or these resources are not present, then a generic help and banner are used.
-cscflags cscFlags-cscflags cscFlags A C# fordítónak (csc.exe) átadandó jelzők.Flags that should be passed to the C# compiler (csc.exe). Ezeket a rendszer változatlanul továbbítja.These are passed through unchanged. Ha ez a paraméter szóközöket tartalmaz, idézőjelek között kell lennie.If this parameter includes spaces, it should be surrounded in double-quotes.
-?-?

– Súgó-help
A szerzői jogi üzenet és a Make-shell parancssori kapcsolók megjelenítése.Displays the copyright message and Make-Shell command line options.
-részletes-verbose Részletes információkat jelenít meg a rendszerhéj létrehozása közben.Displays detailed information while the shell is being created.

Lásd még:See Also

Windows PowerShell – programozói útmutatóWindows PowerShell Programmer's Guide

Windows PowerShell SDKWindows PowerShell SDK