Skapa ett konsolgränssnitt

Windows PowerShell ett Make-Shell-verktyg, även kallat "make-kit", som används för att skapa ett konsolgränssnitt som inte kan utökas. Gränssnitt som skapats med det här nya verktyget kan inte utökas senare via Windows PowerShell snapin-modulen.

Syntax

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

Parametrar

Här är en kort beskrivning av parametrarna för Make-Shell.

Varning

UNC-sökvägar till sammansättningar stöds inte av Make-Shell.

Parameter	Beskrivning
-out n.exe	Krävs. Namnet på det gränssnitt som ska produceras. Sökvägen anges som en del av den här parametern. Make-shell lägger till ".exe" i det här värdet om det inte har angetts. Varning: Skapa inte en utdatafil med samma namn som den refererade .dll filen. Om du försöker göra detta skapar Make-Shell-verktyget en .cs-fil med samma namn, vilket skriver över CS-filen som innehåller din cmdlet-källkod.
-namespace ns	Krävs. Namnområdet som ska användas för den härledda klassen System.Management.Automation.Runspaces.Runspaceconfiguration som make-kit genererar och kompilerar.
-libdirectory1[,libdirectory2,..]	De kataloger som genomsöks efter .NET-sammansättningar, inklusive Windows PowerShell-sammansättningar, sammansättningar som anges av parametern, sammansättningar som indirekt refereras till av en annan sammansättning och reference .NET-systemsammansättningar.
-reference ca1.dll[,ca2.dll,...]	En kommaavgränsad lista över sammansättningar som ska ingå i gränssnittet. Dessa sammansättningar innehåller alla cmdlet- och providersammansättningar, samt resurssammansättningar som ska läsas in. Om den här parametern inte anges skapas ett gränssnitt som endast innehåller de kärn-cmdlets och providers som tillhandahålls av Windows PowerShell. Sammansättningarna kan anges med hjälp av den fullständiga sökvägen, annars genomsöks de efter med hjälp av den sökväg som anges av lib parametern .
-formatdata fd1.format.ps1xml[,fd2.format.ps1xml,...]	En kommaavgränsad lista med formatdata som ska ingå i gränssnittet. Om den här parametern inte anges skapas ett gränssnitt som endast innehåller de formatdata som Windows PowerShell.
-typedata td1.type.ps1xml[,td2.type.ps1xml,...]	En kommaavgränsad lista med typdata som ska ingå i gränssnittet. Om den här parametern inte anges skapas ett gränssnitt som endast innehåller de typdata som Windows PowerShell.
-source c1.cs [,c2.cs,...]	Namnet på en fil som tillhandahålls av shell-utvecklaren och som innehåller den källkod som behövs för att skapa gränssnittet. Källkodsfilen kan innehålla någon av följande källkod: – Auktoriseringshanterarens implementering som åsidosätter standardauktoriseringshanteraren. (Detta kan också kompileras till en sammansättning.) – Deklarationer av sammansättningsinformationsattribut: till exempel AssemblyCompanyAttribute, AssemblyCopyrightAttribute, AssemblyFileVersionAttribute, AssemblyInformationalVersionAttribute, AssemblyProductAttribute och AssemblyTrademarkAttribute.
-authorizationmanager authorizationManagerType	Den typ som innehåller implementeringen av auktoriseringshanteraren. Detta kan definieras i källkoden eller kompileras till en sammansättning (anges av reference parametern ). Om den här parametern inte anges används standardsäkerhetshanteraren. Värdet ska vara det fullständiga typnamnet, inklusive namnområden.
-win32icon i.ico	Ikonen för .exe för gränssnittet. Om det inte anges har gränssnittet ikonen som c#-kompilatorn innehåller (om det finns någon).
-initscript p.ps1	Gränssnittets startprofil. Filen inkluderas i "i"- eller "as-is"-filen. ingen giltighetskontroll utförs av Make-Shell.
-builtinscript s1.ps1[,s2.ps1,...]	En lista över inbyggda skript för gränssnittet. Dessa skript identifieras före skript i sökvägen och deras innehåll kan inte ändras när gränssnittet har skapats. Filerna inkluderas i "i as-is"- eller "as-is"-filen. ingen giltighetskontroll utförs av Make-Shell.
-resource resourcefile.txt	Filen .txt innehåller hjälp- och banderollresurser för gränssnittet. Den första resursen heter ShellHelp och innehåller texten som visas om gränssnittet anropas med help parametern . Den andra resursen heter ShellBanner och innehåller texten och upphovsrättsinformationen som visas när gränssnittet startas i interaktivt läge. Om den här parametern inte anges, eller om dessa resurser inte finns, används en allmän hjälp och banderoll.
-cscflags cscFlags	Flaggor som ska skickas till C#-kompilatorn (csc.exe). Dessa skickas utan att de ändras. Om den här parametern innehåller blanksteg ska den omges av dubbla citattecken.
-? -help	Visar upphovsrättsmeddelandet och Make-Shell kommandoradsalternativ.
-verbose	Visar detaljerad information när gränssnittet skapas.

Se även

Programmeringsguide för Windows PowerShell

Windows PowerShell SDK