Skapa ett konsolgränssnittHow to Create a Console Shell

Windows PowerShell innehåller ett Make-Shell verktyg, även kallat "make-kit", som används för att skapa ett konsol gränssnitt som inte är utöknings Bart.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. Gränssnitt som skapats med det här nya verktyget kan inte utökas senare via en Windows PowerShell-snapin-modul.Shells created with this new tool cannot be extended later through a Windows PowerShell snap-in.

SyntaxSyntax

Här är den syntax som används för att köra Make-Shell inifrån en-fil.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 ]

Parameters (Parametrar)Parameters

Här är en kort beskrivning av parametrarna för märke-Shell.Here is a brief description of the parameters of Make-Shell.

Varning

UNC-sökvägar till sammansättningar stöds inte av skapa-gränssnitt.UNC paths to assemblies are not supported by Make-Shell.

ParameterParameter BeskrivningDescription
n.exe-out n.exe Krävs.Required. Namnet på det gränssnitt som ska skapas.The name of the shell to produce. Sökvägen anges som en del av den här parametern.The path is specified as part of this parameter.

Med-Shell läggs ". exe" till i det här värdet om det inte anges.Make-shell will append ".exe" to this value if it is not specified. Varning: Skapa inte en utdatafil med samma namn som den refererade DLL-filen.Caution: Do not create an output file with the same name as the referenced .dll file. Om du gör det skapar Make-Shell-verktyget en. CS-fil med samma namn, vilket skriver över. cs-filen som innehåller käll koden för cmdleten.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.
-namnrymd ns-namespace ns Krävs.Required. Namn området som ska användas för den härledda system. Management. Automation. körnings utrymmen. Runspaceconfiguration -klassen som gör-satsen genererar och kompilerar.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,..] De kataloger som genomsöks för .NET-sammansättningar, inklusive Windows PowerShell-sammansättningar, sammansättningar som anges av reference parametern, sammansättningar som indirekt refereras till av en annan sammansättning och .net-systemets sammansättningar.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.
-referens ca1.dll [, ca2.dll,...]-reference ca1.dll[,ca2.dll,...] En kommaavgränsad lista över de sammansättningar som ska ingå i gränssnittet.A comma-separated list of the assemblies to include in the shell. Dessa sammansättningar innehåller alla cmdlet-och Provider-sammansättningar, samt resurs sammansättningar som ska läsas in.These assemblies includes all cmdlet and provider assemblies, as well as resource assemblies that should be loaded. Om den här parametern inte anges skapas ett gränssnitt som bara innehåller de kärn-cmdlets och providers som tillhandahålls av Windows PowerShell.If this parameter is not specified, then a shell is produced that contains only the core cmdlets and providers provided by Windows PowerShell.

Sammansättningarna kan anges med hjälp av sin fullständiga sökväg, annars söks de igenom med den sökväg som anges av lib parametern.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,...] En kommaavgränsad lista med format data som ska tas med i gränssnittet.A comma-separated list of format data to include in the shell. Om den här parametern inte anges skapas ett gränssnitt som bara innehåller de format data som tillhandahålls av Windows PowerShell.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,...] En kommaavgränsad lista med typ data som ska tas med i gränssnittet.A comma-separated list of type data to include in the shell. Om den här parametern inte anges skapas ett gränssnitt som bara innehåller de typ data som tillhandahålls av Windows PowerShell.If this parameter is not specified, then a shell is produced that contains only the type data provided by Windows PowerShell.
-source c1.cs [, c2.cs,...]-source c1.cs [,c2.cs,...] Namnet på en fil, som tillhandahålls av Shell-utvecklaren, som innehåller alla käll koder som krävs för att bygga gränssnittet.The name of a file, provided by the shell developer, that contains any source code needed to build the shell.

Käll kods filen kan innehålla någon av följande käll koder:The source code file can contain any of the following source code:

– Den Auktoriseringshanteraren-implementering som åsidosätter standard hanteraren för Auktoriseringshanteraren.- The Authorization manager implementation that overrides the default authorization manager. (Detta kan också anges kompileras till en sammansättning.)(This could also be supplied compiled into an assembly.)
– Assembly information Attribute-deklarationer: till exempel AssemblyCompanyAttribute, AssemblyCopyrightAttribute, AssemblyFileVersionAttribute, AssemblyInformationalVersionAttribute, AssemblyProductAttribute och AssemblyTrademarkAttribute.- Assembly informational attribute declarations: such as the AssemblyCompanyAttribute, AssemblyCopyrightAttribute, AssemblyFileVersionAttribute, AssemblyInformationalVersionAttribute, AssemblyProductAttribute, and AssemblyTrademarkAttribute.
-authorizationmanager authorizationManagerType-authorizationmanager authorizationManagerType Den typ som innehåller implementeringen av Auktoriseringshanteraren.The type that contains the authorization manager implementation. Detta kan definieras i käll koden eller kompileras till en sammansättning (anges av reference parametern).This can be defined in source code, or compiled into an assembly (specified by the reference parameter). Om den här parametern inte anges används standard säkerhets hanteraren.If this parameter is not specified, the default security manager is used. Värdet ska vara ett fullständigt typnamn, inklusive namn områden.The value should be the full type name, including namespaces.
-win32icon i. ico-win32icon i.ico Ikonen för. exe-filen för gränssnittet.The icon for the .exe file for the shell. Om detta inte anges kommer gränssnittet att ha den ikon som c#-kompilatorn inkluderar (om det finns några).If not specified, then the shell will have the icon that the c# compiler includes (if any).
– initscript p.ps1-initscript p.ps1 Start profilen för gränssnittet.The startup profile for the shell. Filen ingår "i befintligt skick"; ingen giltighets kontroll utförs med ett märke.The file is included "as-is"; no validity checking is done by Make-Shell.
-builtinscript s1.ps1 [, s2.ps1,...]-builtinscript s1.ps1[,s2.ps1,...] En lista med inbyggda skript för gränssnittet.A list of built-in scripts for the shell. Dessa skript identifieras före skript i sökvägen och deras innehåll kan inte ändras när gränssnittet har skapats.These scripts are discovered before scripts in the path, and their contents cannot be changed once the shell is built.

Filerna ingår "i befintligt skick"; ingen giltighets kontroll utförs med ett märke.The files are included "as-is"; no validity checking is done by Make-Shell.
– resurs resourcefile.txt-resource resourcefile.txt Txt-filen som innehåller hjälp-och informations resurser för gränssnittet.The .txt file containing help and banner resources for the shell. Den första resursen heter ShellHelp och innehåller den text som visas om gränssnittet anropas med help parametern.The first resource is named ShellHelp, and contains the text displayed if the shell is invoked with the help parameter. Den andra resursen heter ShellBanner och innehåller texten och copyrightinformation som visas när gränssnittet startas i interaktivt läge.The second resource is named ShellBanner, and it contains the text and copyright information displayed when the shell is launched in interactive mode.

Om den här parametern inte anges eller om dessa resurser inte finns, används en generisk hjälp och banderoll.If this parameter is not provided, or these resources are not present, then a generic help and banner are used.
-cscflags cscFlags-cscflags cscFlags Flaggor som ska skickas till C#-kompilatorn (csc.exe).Flags that should be passed to the C# compiler (csc.exe). Dessa skickas genom oförändrade.These are passed through unchanged. Om den här parametern innehåller blank steg ska den omges av dubbla citat tecken.If this parameter includes spaces, it should be surrounded in double-quotes.
-?-?

– hjälp-help
Visar Copyright-meddelandet och Make-Shell kommando rads alternativ.Displays the copyright message and Make-Shell command line options.
– utförlig-verbose Visar detaljerad information medan gränssnittet skapas.Displays detailed information while the shell is being created.

Se ävenSee Also

Programmeringsguide för Windows PowerShellWindows PowerShell Programmer's Guide

Windows PowerShell SDKWindows PowerShell SDK