Parametr PowerShell: Syntaxe, typy, atributy, argumenty a příklady

15. června 2021 16760 Pohledy Parametr PowerShell: Syntaxe, typy, atributy, argumenty a příklady

Vývojáři skriptů PowerShell používají blok Powershell Param k přidávání parametrů do pokročilých funkcí. Kdokoli spouští funkci, má přístup k parametrům přidaným pomocí PowerShell Param.

Kromě parametrů přidaných do funkce pomocí bloku Param navíc Windows PowerShell automaticky přidává Common Parameters .

Tato příručka popisuje syntaxi Powershell Param, typy parametrů Powershell, jejich atributy a argumenty. Uvádí také několik příkladů, jak použít blok Param k přidání parametrů do skriptu nebo funkce.

Procházet témata příspěvků

Syntaxe bloku parametrů PowerShell

Syntaxe bloku parametrů PowerShell

Syntaxe PowerShell Param je…

|_+_|

Chcete-li přidat parametr do funkce , začněte slovem stop , následovaný blokem parametrů, (). Zde je jednoduchá forma bloku param…

|_+_| The CmdletBinding atribut je volitelný a je to jediný atribut definovaný mimo blok param. Více o tom později v průvodci

V rámci bloku Param – param () – definujete atributy Parameter a jejich argumenty. Kromě toho je atribut parametru uzavřen v bloku [()].

Ve výše uvedeném syntaktickém kódu jsem zvýraznil všechny argumenty parametrů. Argumentů parametrů je mnohem více – ty v syntaxi jsou pouze pro ilustrační účely a nejsou v žádném případě vyčerpávající.

V rámci bloku parametrů definujete argumenty parametrů oddělené čárkami. Příkladem atributu PowerShell Param je parametr atribut.

Navíc příkladem argumentu param je argument povinné argument. Dalším příkladem argumentu param je ParametrSetName .

Nakonec definujete název parametru. Kromě toho určíte také datový typ parametru.

V další části proberu běžné typy parametrů PowerShellu. Poté se třetí část zabývá obecnými atributy parametrů a jejich argumenty.

Nakonec v poslední části této příručky uvedu reálný příklad SysAdmin parametru PowerShell. Tato část také uvede příklady, jak používat blok param v pokročilé funkci.

Typy parametrů PowerShellu

Typy parametru PowerShell Param

Nejběžnější typy parametrů, které můžete nastavit, jsou tětiva nebo přepínač parametry. Kromě toho můžete také definovat int , bool , Čas schůzky nebo typy parametrů char.

V této části vysvětlím některé z těchto typů parametrů. Uvedu také několik příkladů, jak je definovat v bloku param.

Parametr PowerShell Tětiva Parametr

Když vytváříte parametry PowerShellu, je pravděpodobné, že vytvoříte a tětiva parametr. A tětiva parametr přijímá libovolnou řetězcovou hodnotu.

V prostředí Windows PowerShell může řetězec obsahovat čísla, slova nebo znaky. Konkrétně vše, co deklarujete ve dvojitých nebo jednoduchých uvozovkách, je řetězec.

V PowerShellu je typ objektu řetězce System.String .

Chcete-li deklarovat parametr PowerShell jako parametr řetězce, uzavřete před název parametru slovo tětiva v závorkách. Zde je příklad…

|_+_|

Parametr PowerShell int Parametr

An int datový typ je 32bitové celé číslo se znaménkem. V angličtině, an int je číslo, například 1, 2 nebo 3.

Na rozdíl od a tětiva datový typ parametru, který může přijmout jakýkoli typ dat, an int parametr je velmi normativní.

Pokud definujete int Parametr může přijímat pouze čísla. Dále, pokud zadáte slova jako hodnotu pro int parametr, PowerShell vyvolá chybovou zprávu.

Než vám ukážu, jak definovat PowerShell Param int parametr, zde je obecný příklad, jak definovat datový typ int…

|_+_|

Pokud spustím kód v PowerShellu, vrátí se 123 .

PowerShell Param int Parametr

Naopak, pokud nahradím 123 tímto je int, PowerShell vyhodí chybovou zprávu.

|_+_|

Nyní, když jste měli int datový typ rychlokurzu k vytvoření PowerShell Param int parametr nazvaný číslo, zde je kód…

|_+_|

To donutí uživatele vašeho skriptu nebo funkce poskytnout správný datový typ.

Parametr PowerShell Čas schůzky Parametr

Jako int parametr, a Čas schůzky Parametr je také velmi normativní pro typ vstupu, který přijímá. Jak název napovídá, Čas schůzky Parametr bude přijímat pouze vstupy ve formátu Datum a Čas.

Pokud chcete definovat parametr PowerShellu, který bude přijímat pouze data, použijte ukázkový kód níže…

|_+_|

V tomto příkladu Zadejte Datum je název parametru. Dodatečně, Čas schůzky definuje datový typ.

Parametr PowerShell Přepínač Parametr

V prvních třech podsekcích této části jsem diskutoval o typech parametrů prostředí PowerShell, které vyžadují vstup od uživatele.

Existuje však typ parametru PowerShell, který nevyžaduje vstup od uživatele. Na rozdíl od jiných typů parametrů, a přepínač parametr nevyžaduje vstup uživatele.

Způsob, jakým definujete a přepínač parametr je podobný způsobu, jakým definujete jiné typy parametrů. Nicméně, na místě přepínač , int , nebo čas schůzky , použijte slovo přepínač .

Chcete-li například definovat parametr PowerShell Přepínač parametr, Exportovat CSV , použijte kód níže…

|_+_|

A konečně, pro tuto sekci vás možná zajímá aplikace přepínač parametry. Představte si skript nebo funkci prostředí PowerShell, které mohou zobrazovat výsledky v konzole Powershell.

Můžete také dát uživateli možnost exportovat výsledek do textového souboru nebo souboru CSV.

Jedním ze způsobů kódování funkce je vytvoření 3 parametrů přepínače. Uživatel pak může vybrat jeden z parametrů v závislosti na tom, jak chce, aby funkce poskytla výsledek.

Tento typ parametru nevyžaduje, aby uživatel zadával vstup. Pouhým výběrem parametru funkce odpovídajícím způsobem zobrazí výstup.

Můžete také definovat další parametry PowerShellu se specifickými datovými typy. Chcete-li se dozvědět o typech dat PowerShellu, navštivte tento odkaz – Jak definovat datové typy PowerShell .

Atributy a argumenty parametru PowerShell

Atributy a argumenty parametru PowerShell

V syntaxi PowerShell Param této příručky jsem naznačil, že parametr PowerShellu má atributy. Navíc jsem také poukázal na to, že každý atribut parametru má také argumenty.

V této části budu diskutovat o atributech parametrů a jejich argumentech.

Abych vysvětlil atributy parametrů a jejich argumenty, budu odkazovat na syntaxi PowerShell param představenou v první části této příručky.

|_+_|

Parametr PowerShell CmdletBinding Atribut

The CmdletBinding atribut je obvykle uveden před blokem param. Když definujete CmdletBinding atribut, PowerShell rozpozná skript jako pokročilou funkci.

V sekci syntaxe této příručky jsem tento kód použil jako zjednodušenou verzi bloku param.

|_+_|

V této části se zaměřím na CmdletBinding Atribut část kódu. Zde je návod, jak definovat Atribut

|_+_|

V následujících 3 podsekcích proberu některé běžné argumenty, které můžete definovat v CmdletBinding atribut.

Aby se předešlo pochybnostem, musíte definovat všechny Argumenty v bloku () Atribut . Také MUSÍTE oddělit všechny atributy čárkou (,), kromě posledního Argumenty v rámci Atribut .

Parametr PowerShell DefaultParameterSetName Argument

Když vyvíjíte funkci PowerShell, může obsahovat více parametrů, které může uživatel použít ve stejném příkazu. Kromě toho může stejná funkce PowerShell obsahovat další sadu parametrů, které může uživatel použít v jiném příkazu.

Uživatel však nemůže kombinovat parametry v první sadě s parametry ve druhé sadě.

Kromě toho vývojář funkce definuje všechny parametry, které může uživatel použít ve stejném příkazu s ParametrSetName argument. The ParametrSetName argument je definován v atributu Parametr (více o tom v další části).

Důsledkem různých sad seskupených parametrů je, že budete mít různé ParametrSetName s.

S různými ParametrSetName s defied ve vašem bloku parametrů, můžete se rozhodnout definovat jeden z ParametrSetName s jako výchozí. Toto je místo, kde používáte DefaultParameterSetName Argument.

The DefaultParameterSetName Argument je definován v CmdletBinding blok atributů. Zde je příklad…

|_+_|

A konečně, abychom zachovali náš formát bloku parametrů PowerShell, znovu zavedu blok param níže…

|_+_|

Parametr PowerShell PodporujeShouldProcess Argument

Toto je další argument, který můžete definovat v CmdletBinding Atribut . Jako DefaultParameterSetName Argument, PodporujeShouldProcess Argument je volitelný.

The PodporujeShouldProcess Argument dodává Potvrdit a Co když společné parametry funkce.

Chcete-li přidat tento argument, přidejte na konec znaku čárku (,). DefaultParameterSetName argument. Poté přidejte řádek - PodporujeShouldProcess =$true nebo $false.

S tímto novým argumentem, včetně CmdletBinding Atribut teď bude vypadat takto…

|_+_|

Parametr PowerShell HelpURI Argument

Pokud znáte prostředí PowerShell Získejte pomoc Cmdlet, možná jste na něj narazili online parametr. Když běžíš Získejte pomoc s online PowerShell otevře stránku online nápovědy rutiny.

Chcete-li například otevřít stránku online nápovědy rutiny Out-File, spusťte níže uvedený příkaz...

|_+_|

Stránka otevřená tímto příkazem je definována ve funkci pomocí HelpURI Argument. Pokud tedy chcete, aby uživatelé měli přístup na stránku online nápovědy vaší funkce, definujte HelpURI Argument.

Zde je příklad…

|_+_|

Nyní zahrnu tento poslední argument do CmdletBinding Atribut . Zde je aktualizovaný kód…

|_+_|

Parametr PowerShell Parametr Atribut

V parametru PowerShell CmdletBinding Podsekce atributů, diskutoval jsem o 3 argumentech, které můžete zahrnout do CmdletBinding Blok atributů.

Jak jste viděli, CmdletBinding Blok atributů je jediný atribut definovaný mimo blok parametrů.

V této podsekci se dozvíte o atributu parametru. Kromě toho se také dozvíte o běžných argumentech, které můžete přidat k tomuto atributu.

Jak jste možná odvodili z příkladů již použitých v této příručce, Atribut parametru definuje argumenty, které řídí chování parametru PowerShell param.

Atribut parametru můžete definovat uzavřením slova Parametr následovaného závorkami () v bloku []. Zde je příklad…

|_+_|

Dále MUSÍTE definovat všechny argumenty atributu parametru v bloku ().

V následujících podsekcích sekce PowerShell Param Parameter Attribute představím a vysvětlím běžné argumenty, které můžete definovat v rámci Atributu parametru.

Parametr PowerShell ParametrSetName Argument

Když jsem vysvětlil DefaultParameterSetName dříve v této příručce jsem představil ParametrSetName Argument. Tento argument můžete použít k dávkování nebo seskupování parametrů, které může uživatel spustit ve stejném příkazu.

Chcete-li například definovat a ParametrSetName volala Název sady parametrů1 , zadejte kód níže do bloku Atribut parametru ().

|_+_|

Když představím tento aktualizovaný kód, blok param mého ukázkového kódu bude nyní vypadat takto..

|_+_|

Pokud přinesu zpět CmdletBinding Atribut, můj ukázkový parametr PowerShell bude nyní vypadat takto…

|_+_|

Parametr PowerShell Povinné Argument

Můžete použít Povinné argument k definování, zda je parametr povinný nebo volitelný. The Povinné argument přijímá hodnotu $true nebo $false – $true znamená vyžadovat, $false, není vyžadováno.

Kromě toho, Povinné argument je volitelný. Pokud však tento argument není definován, bude parametr považován za volitelný.

Chcete-li definovat Povinné Argument, přidejte níže uvedený kód do bloku Atribut parametru…

|_+_|

Konečně, pokud zahrnu Povinné Kód argumentu k mému param kódu PowerShell, teď budu mít…

|_+_|

Parametr PowerShell Pozice Argument

The Pozice Argument parametru Atribut definuje pozici parametru. Hodnota je celé číslo počínaje 0 (nulou).

Přínos z Pozice Argumentem je umožnit uživatelům spouštět funkci pomocí pozice parametrů. Konkrétně, když definujete Pozice Argument, uživatel může zadat hodnoty pro každý parametr do příkazového řádku bez zadání parametru.

PowerShell pak přiřadí každou hodnotu v příkazovém řádku podle pozice parametru.

Například, Get-ChildItem Rutina má parametr nazvaný Cesta (s pozicí 0). Rutina má také další parametr, Filtr (s pozicí 1).

Ve výchozím nastavení, pokud spustím Get-ChildItem příkazu, musím zahrnout názvy parametrů před přidáním jejich hodnot. Viz příkaz níže…

|_+_|

V tomto příkazu jsem zavolal parametry a poté specifikoval jejich hodnoty.

Argument pozice parametru PowerShell

Protože však znám pozice těchto 2 parametrů, mohu přidat hodnoty na jejich pozice, aniž bych parametry výslovně volal. Poté svůj příkaz upravím, jak je uvedeno níže…

|_+_|

To mi samozřejmě šetří čas! Pokud se však díváte na dlouhý kód PowerShell, může to způsobit určitý zmatek.

Příkaz dává stejný výsledek v PowerShell…

PowerShell automaticky přiřadí hodnoty na pozicích k parametrům na základě jejich Pozice Argument.

Pokračujeme, zde je způsob, jak definovat Pozice Argument…

|_+_| V tomto příkladu je moje pozice parametru 0 (nula). Když definuji svůj další parametr, bude na pozici 1 a tak dále. Nemůžete mít dva parametry na stejné pozici. Později v průvodci se dozvíte, jak přidat jeden parametr na stejnou pozici, ale různé ParameterSetNames.

Nyní přidám tento argument do svého ukázkového kódu…

|_+_|

Parametr PowerShell ValueFromPipeline Argument

Dalším běžně používaným rozšířením parametrů je ValueFromPipeline Argument. Jak název napovídá, tento argument určuje, zda parametr přijímá hodnoty z kanálu.

Ona je, jak definujete tento argument…

|_+_|

Pokud přidám tento nový argument do svého kódu, bude to vypadat takto…

|_+_|

Existuje další argument zvaný ValueFromPipelineByPropertyName . Chcete-li si o tomto argumentu přečíst, navštivte about_Functions_Advanced_Parameters .

Parametr PowerShell HelpMessage Argument

Tento argument můžete použít k určení zprávy, která uživatelům ukáže, jak použít parametr. Chcete-li definovat a HelpMessage Argument pro parametr, použijte kód podobný tomu níže…

|_+_|

A tady je můj aktualizovaný kód…

|_+_|

V této části jsem zatím diskutoval o 2 atributech parametrů PowerShell – CmdletBinding a Parametr . Kromě toho jsem také diskutoval o běžných argumentech, které můžete pro tyto atributy definovat.

Ve zbývajících 3 podsekcích této sekce vás naučím 3 běžněji používané atributy parametrů PowerShellu. Tyto 3 atributy však nevyžadují, abyste definovali argumenty.

Parametr PowerShell Přezdívka Atribut

Atribut alias se používá k určení aliasů parametru. Jak jste možná uhodli, místo parametru lze použít alias parametru PowerShell.

Než vám ukážu, jak definovat atribut alias pro parametr, dovolte mi nejprve ukázat, jak najít aliasy všech rutin a funkcí na vašem počítači.

Chcete-li vypsat všechny aliasy pro rutiny a funkce, spusťte níže uvedený příkaz

|_+_|

Zobrazí se seznam všech aliasů…

PowerShell Param Alias ​​atribut

Přesun na Přezdívka Atribut, k definování jednoho pro parametr PowerShell param, použijte kód podobný tomu níže…

|_+_| V tomto příkladu je FP alias pro parametr.

Pokud to přidám do svého kódu, aktualizovaná verze bude vypadat takto…

|_+_|

Parametr PowerShell Podporuje zástupné karty Atribut

Tento atribut param určuje, zda parametr přijímá zástupné znaky. Takto definujete tento atribut…

|_+_|

Parametr PowerShell ValidateNotNullOrEmpty Atribut ověření

Stejně jako většina atributů, které již byly popsány v této příručce, název tohoto atributu to také prozrazuje. Je to atribut ověření.

Když definujete tento atribut, parametr NEBUDE přijímat hodnotu null ($null). Navíc nebude přijímat prázdnou hodnotu ().

Pokud uživatel zadá $null nebo , funkce vyvolá chybu. Chcete-li definovat tento atribut, zadejte níže uvedený kód…

|_+_|

Nakonec aktualizuji svůj kód o poslední 2 atributy…

|_+_|

Název parametru parametru PowerShell

Po definování všech atributů a argumentů parametru je třeba přidat název parametru. Parametr PowerShell param je definován jako proměnná – se znakem dolaru ($), za kterým následuje název parametru.

Volitelně můžete také zadat datový typ parametru. V části 2 této příručky jsem diskutoval o různých typech parametrů prostředí PowerShell.

Zde je návod, jak definovat parametr, který lze přijmout tětiva datový typ.

|_+_|

Zde je můj aktualizovaný příklad kódu…

|_+_|

Jak definovat jeden parametr PowerShell ve více sadách parametrů

Jak definovat jeden parametr PowerShell ve více sadách parametrů

Pokud s kódováním funkcí PowerShellu začínáte, je pravděpodobné, že podlehnete pokušení definovat jeden parametr vícekrát.

Jedním z důvodů, proč můžete chtít mít parametr vícekrát, je, když je parametr použit ve více ParameterSetNames (více sad parametrů).

Chcete-li řídit tento domov, řekněme, že vyvíjíte funkci PowerShell, která má a Cesta parametr. Máte však 2 ParameterSetNames, které vyžadují parametr Path.

Většina lidí, kteří začínají se skriptováním PowerShellu, pravděpodobně definuje parametry, které jsou uvedeny níže…

|_+_|

Pokud definujete parametry, jak je uvedeno výše, obdržíte chybovou zprávu. Abych tuto teorii otestoval, zkopíruji kód do PowerShell ISE .

Jak definovat jeden parametr PowerShell ve více sadách parametrů

Jak to tedy napravit? Řešením je definovat 2 atributy parametrů a jejich argumenty – včetně jejich ParameterSetNames.

Potom na konci obou atributů parametru definujte jeden název parametru, který je společný pro oba atributy parametrů. V předchozím příkladu odstraním název prvního parametru a ponechám poslední.

|_+_|

Nyní, když zkopíruji tento kód do PowerShell ISE, bude to v pořádku.

V tomto příkladu si všimněte, že argumenty parametrů pro oba atributy parametrů mohou být zcela odlišné. Navíc můžete definovat tolik atributů parametrů, kolik chcete.

Příklady parametrů PowerShellu

Příklady parametrů PowerShellu

V této poslední části průvodce uvedu skutečný příklad parametru SysAdmin PowerShell.

Když jsem psal tuto příručku, začal jsem vyvíjet skript/funkci PowerShell, abych získal velikost složky a počet souborů. Zde je param část funkce…

|_+_|

V několika následujících podsekcích této části vysvětlím různé prvky param. Nakonec poslední sekce zavádí funkční blok a přidává blok param do funkce.

Aby pro vás bylo snadné sledovat řádky v kódu, na které se odkazuje v dalších podsekcích, stáhněte si PowerShellParamExample.zip . Poté soubor rozbalte a otevřete soubor .ps1 v PowerShell ISE .

ParametrSetName Příklad parametru PowerShell

Můj ukázkový kód parametru PowerShell má tři ParameterSetName – DisplayResult , ExportTxt a Exportovat CSV . Použil jsem tato jména, aby bylo snadné identifikovat, co dělají.

V úvodu této části jsem zmínil, že funkce, kterou vytvářím s tímto param kódem, zobrazí velikost složky a počet souborů pro každou podsložku v určené složce.

Proto tři ParameterSetNames nabízejí uživateli možnost zobrazit výsledky v konzole PowerShell. Alternativně má uživatel možnost exportovat výsledek do textového souboru nebo souboru CSV.

Navíc každý ParametrSetName definovat všechny parametry, které může uživatel volat v jediném příkazu. Na základě této myšlenky bude mít funkce, kterou buduji, tři možnosti příkazů nebo syntaxe.

Tuto myšlenku rozvedu v následujících podsekcích a příkladech.

CmdletBinding Atribut And DefaultParameterSetName Příklady argumentů

V předchozích částech této příručky jste narazili na CmdletBinding Atribut. Navíc jste také narazil na jeden z jeho argumentů – DefaultParameterSetName .

The DefaultParameterSetName argument se používá k definování výchozí sady parametrů, kterou funkce volá. V tomto příkladu je výchozí název sady parametrů DisplayResult .

The DefaultParameterSetName je deklarován na řádku 1 kódu.

PowerShell se pokusí použít sadu parametrů deklarovanou DefaultParameterSetName pokud nemůže určit, kterou sadu parametrů použít. Pokud však nastavíte povinné parametry, můžete se tomuto problému vyhnout.

V každém případě není na škodu deklarovat výchozí název sady parametrů.

Cesta ke složce Příklad parametru řetězce

Tady začíná zábava! The Cesta ke složce Parametr se používá k zadání cesty ke složce, funkce získá velikost svých podsložek – a spočítá počet souborů v každé podsložce.

Toto je parametr řetězce. To znamená, že přijímá jakýkoli řetězec jako vstup.

Jedna vzrušující vlastnost Cesta ke složce Parametr je, že je společný pro názvy 3 sad parametrů. Dříve v tomto článku jsem vysvětlil problém, kterému mohou v této situaci čelit noví vývojáři skriptů PowerShell.

Prohlásit Cesta ke složce ve třech názvech sad parametrů jsem vytvořil tři atributy parametrů.

Atribut prvního parametru je mezi řádky 5 a 11. Tento atribut prvního parametru má navíc více argumentů.

Byl bych však rád, abyste věnovali zvláštní pozornost ParametrSetName argument - DisplayResult .

Příklad parametru řetězce FolderPath

Za druhé, mezi řádky 12 a 18 jsem deklaroval další atribut parametru s a ParametrSetName volal argument ExportTxt .

Nakonec jsem mezi řádky 19 a 25 deklaroval třetí atribut parametru s a ParametrSetName volal argument Exportovat CSV .

Příklad parametru řetězce FolderPath

Navíc, pokud si všimnete, na rozdíl od deklarování atributů 3 parametrů jsem deklaroval jeden Přezdívka , a ValidateNotNullOrEmpty atributy. Tyto atributy najdete na řádcích 26 a 27.

Příklad parametru řetězce FolderPath

Nakonec jsem těsně pod všechny atributy a jejich argumenty uvedl název parametru – Cesta ke složce . Název parametru je na řádku 28.

Příklad parametru řetězce FolderPathV poslední podsekci této části uvidíte, jak funkce zobrazuje tento parametr ve 3 syntaxích příkazů.

DisplayResult , ExportTxt A Exportovat CSV Příklad parametru přepínače

Od řádku 29 kódu param jsem deklaroval další sadu atributů parametrů a jejich argumentů.

Nejprve mezi řádky 29 a 37 deklaruji atributy parametrů a argumenty pro DisplayResult parametr.

Poté mezi řádky 38 a 47 deklaruji další parametr nazvaný ExportTxt .

Příklad parametru přepínače DisplayResult, ExportTxt a ExportCSV

Nakonec jsem mezi řádky 48 a 57 prohlásil Exportovat CSV parametr.

3 parametry, které jsem popsal v této části, jsou všechny Přepínač parametry. Jak již víte, znamená to, že parametry nevyžadují žádný vstup od uživatele.

Když uživatel vybere některý z parametrů, funkce změní způsob, jakým zobrazuje výsledky.

Jak používat parametr PowerShell ve funkci PowerShell

V této podsekci chci do svého příkladu kódu zavést funkční blok PowerShell.

Syntaxe funkčního bloku PowerShell je…

|_+_|

Pro poslední příklad v této příručce nahradím blok parametrů PowerShell v syntaxi funkce mým kódem param z poslední podsekce. Dodatečně nahradím funkci za Get-FolderSizeFileCount , název funkce.

Konečná funkce bude nyní vypadat takto…

|_+_| V tomto příkladu jsou bloky Začátek {}, Proces {} a Konec {} prázdné.

Testování mých parametrů PowerShell ve funkci PowerShell

V této závěrečné části otestuji parametry ve funkci, kterou jsem vytvořil v minulé části.

Pokud si to chcete sami vyzkoušet, můžete si kód stáhnout kliknutím na tento odkaz – Get-FolderSizeFileCount.zip . Poté rozbalte soubor zip.

Po rozbalení souboru otevřete PowerShell a spusťte níže uvedený příkaz:

|_+_| Přejděte na úplnou cestu k rozbalenému souboru.

Po spuštění příkazu obdržíte varovnou zprávu. Na výzvu ke zprávě zadejte R a stiskněte klávesu Enter na klávesnici.

Testování mých parametrů PowerShell ve funkci PowerShell

Jakmile je modul importován, spusťte ve stejné konzole PowerShell následující příkaz:

|_+_|

Zde je výsledek příkazu…

Chci vám ukázat část SYNTAX na stránce nápovědy mé funkce. Z výše uvedeného snímku obrazovky můžete spustit příkaz Get-FolderSizeFileCount ve 3 různých příkazech:

|_+_|

První věc, kterou je třeba poznamenat, je, že tyto tři syntaxe mají Cesta ke složce řetězec parametru. Pokud si přečtete tuto příručku, budete vědět proč.

Navíc si všimnete, že první syntaxe má DisplayResult parametr přepínače také. Nakonec ve druhé a třetí syntaxi máte Exportovat CSV , a ExportTxt parametr přepínače resp.

Navíc k Cesta ke složce , a Exportovat CSV parametry a ExportTxt parametry ve druhé a třetí syntaxi, mají také ReportPath řetězec parametru. Tento parametr jsem nezmínil, protože kód deklarace je podobný Cesta ke složce kódu, s některými drobnými rozdíly. The ReportPath se používá k zadání cesty, do které bude funkce ukládat textové sestavy a sestavy souborů CSV.

To je vše – komplexní průvodce parametry PowerShellu! Doufám, že vám to pomohlo?

Pokud vám to pomohlo, hlasujte Ano na otázku Byl tento příspěvek užitečná níže.

Případně můžete položit otázku, zanechat komentář nebo poskytnout další zpětnou vazbu pomocí formuláře Zanechat odpověď, který najdete na konci této stránky.

A nakonec, pro další PowerShell tech S Zones, navštivte naši stránku průvodce Windows PowerShell How-To. Velmi užitečná vám může být také naše stránka Práce z domova.

Reference a další čtení

  1. Jak definovat datové typy PowerShell
  2. about_Functions_Advanced_Parameters
  3. about_Functions_CmdletBindingAttribute