Param PowerShell: sintaksa, vrste, atributi, argumenti in primeri
Razvijalci skriptov PowerShell uporabljajo blok Powershell Param za dodajanje parametrov naprednim funkcijam. Vsakdo, ki izvaja funkcijo, lahko dostopa do parametrov, dodanih s parametrom PowerShell.
Poleg tega Windows PowerShell poleg parametrov, dodanih funkciji z blokom Param, samodejno doda skupne parametre.
Ta priročnik zajema sintakso parametrov Powershell, vrste parametrov Powershell, njihove atribute in argumente. Navaja tudi nekaj primerov, kako uporabiti blok Param za dodajanje parametrov skriptu ali funkciji.
Brskajte po temah objav
- Sintaksa paramskega bloka PowerShell
- Vrste parametrov PowerShell
- Atributi in argumenti parametrov PowerShell
- Kako definirati en parameter PowerShell v več nizih parametrov
- Primeri parametrov PowerShell
- ParameterSetName Primer parametra PowerShell
- Primeri argumentov atributa CmdletBinding in DefaultParameterSetName
- Primer parametra niza FolderPath
- Primer parametrov stikala DisplayResult, ExportTxt in ExportCSV
- Kako uporabljati parameter PowerShell v funkciji PowerShell
- Preizkušanje parametrov PowerShell v funkciji PowerShell
- Reference in dodatno branje
Sintaksa paramskega bloka PowerShell
Sintaksa parametra PowerShell je …
|_+_|
Če želite funkciji dodati parameter, začnite z besedo ustavi , ki mu sledi blok parametrov, (). Tukaj je preprosta oblika paramskega bloka ...
|_+_| The CmdletBinding atribut ni obvezen in je edini atribut, ki je definiran zunaj bloka parametrov. Več o tem kasneje v priročnikuV bloku Param – param () – boste definirali atribute parametrov in njihove argumente. Poleg tega je atribut parametra zaprt v bloku [()].
V zgornji sintaktični kodi sem podebelil vse argumente parametrov. Argumentov parametrov je veliko več – tisti v sintaksi so samo za ilustracijo in nikakor niso izčrpni.
V bloku parametrov boste definirali argumente parametrov, ločene z vejicami. Primer atributa PowerShell Param je parameter atribut.
Poleg tega je primer argumenta param obvezno prepir. Drug primer argumenta param je ParameterSetName .
kako ustvariti bližnjico na snapchatu
Na koncu boste določili ime parametra. Poleg tega boste določili tudi vrsto podatkov parametra.
V naslednjem razdelku bom razpravljal o pogostih vrstah parametrov PowerShell. Nato tretji razdelek zajema skupne atribute parametrov in njihove argumente.
Nazadnje, v zadnjem razdelku tega priročnika, bom podal resničen primer SysAdmin parametra PowerShell. Razdelek bo podal tudi primere uporabe paramskega bloka v napredni funkciji.
Vrste parametrov PowerShell
Najpogostejše vrste parametrov, ki jih lahko nastavite, so vrvica oz stikalo parametrov. Poleg tega lahko tudi definirate int , bool , Datum čas ali vrste parametrov char.
V tem razdelku bom razložil nekatere od teh vrst parametrov. Podal bom tudi nekaj primerov, kako jih definirati v bloku parametrov.
Param. PowerShell Vrvica Parameter
Ko ustvarite parametre PowerShell, je verjetno, da boste ustvarili a vrvica parameter. A vrvica parameter sprejme katero koli vrednost niza.
V Windows PowerShell je niz lahko številke, besede ali znaki. Natančneje, vse, kar navedete v dvojnem ali enojnem narekovaju, je niz.
V PowerShell je vrsta predmeta niza System.String .
Če želite parameter PowerShell deklarirati kot parameter niza, pred imenom parametra priložite besedo vrvica v oklepajih. Tukaj je primer…
|_+_|Param. PowerShell int Parameter
An int podatkovni tip je 32-bitno predpisano celo število. V angleščini, an int je število, na primer 1, 2 ali 3.
Za razliko od a vrvica parameter podatkovni tip, ki lahko sprejme katero koli vrsto podatkov, an int parameter je zelo predpisan.
Če definirate an int parameter, lahko parameter sprejme samo številke. Poleg tega, če vnesete besede kot vrednost za int parameter, bo PowerShell poslal sporočilo o napaki.
Preden vam pokažem, kako definirati parameter PowerShell int parameter, tukaj je splošen primer, kako definirati tip podatkov int ...
|_+_|Če zaženem kodo v PowerShell, se bo vrnila 123 .
Nasprotno, če zamenjam 123 s tem int, bo PowerShell poslal sporočilo o napaki.
|_+_|
Zdaj, ko ste imeli int pospešen tečaj podatkovnega tipa, da ustvarite parameter PowerShell int parameter, imenovan številka, tukaj je koda ...
|_+_|To bo prisililo uporabnike vašega skripta ali funkcije, da zagotovijo pravo vrsto podatkov.
Param. PowerShell Datum čas Parameter
Kot int parameter, a Datum čas parameter je tudi zelo predpisan glede vrste vhoda, ki ga sprejema. Kot že ime pove, Datum čas parameter bo sprejel samo vnose formata datuma in časa.
Če želite definirati parameter PowerShell, ki bo sprejemal samo datume, uporabite spodnjo vzorčno kodo ...
|_+_|V tem primeru Vnesite datum je ime parametra. Poleg tega Datum čas določa vrsto podatkov.
Param. PowerShell Preklopi Parameter
V prvih treh pododdelkih tega razdelka sem razpravljal o vrstah parametrov PowerShell, ki zahtevajo vnos od uporabnika.
Vendar pa obstaja tip parametra PowerShell, ki ne zahteva vnosa od uporabnika. Za razliko od drugih vrst parametrov, a stikalo parameter ne zahteva uporabniškega vnosa.
Način, kako definirate a stikalo parameter je podoben načinu, kako definirate druge vrste parametrov. Vendar pa namesto stikalo , int , oz Datum čas , uporabite besedo stikalo .
Na primer za definiranje parametra PowerShell Preklopi parameter, IzvoziCSV , uporabite spodnjo kodo ...
|_+_|Končno, v tem razdelku se morda sprašujete o uporabi stikalo parametrov. Pomislite na skript ali funkcijo PowerShell, ki lahko prikaže rezultate na Powershell konzoli.
Uporabniku lahko tudi omogočite, da izvozi rezultat v besedilno datoteko ali datoteko CSV.
Eden od načinov za kodiranje funkcije je ustvarjanje 3 parametrov stikala. Uporabnik lahko nato izbere enega od parametrov, odvisno od tega, kako želi, da funkcija prinese rezultat.
Ta vrsta parametra od uporabnika ne zahteva vnosa. Če preprosto izberete parameter, bo funkcija ustrezno prikazala izhod.
Določite lahko tudi druge parametre PowerShell s posebnimi tipi podatkov. Če želite izvedeti več o tipih podatkov PowerShell, obiščite to povezavo – Kako definirati vrste podatkov PowerShell .Atributi in argumenti parametrov PowerShell
V sintaksi parametrov PowerShell tega priročnika sem namignil, da ima parameter PowerShell atribute. Poleg tega sem tudi poudaril, da ima vsak atribut parametra tudi argumente.
V tem razdelku bom razpravljal o atributih parametrov in njihovih argumentih.
Za razlago atributov parametrov in njihovih argumentov se bom skliceval na sintakso parametra PowerShell, predstavljeno v prvem razdelku tega priročnika.
|_+_|Param. PowerShell CmdletBinding atribut
The CmdletBinding atribut je običajno podan pred blokom param. Ko definirate CmdletBinding atributa, bo PowerShell prepoznal skript kot napredno funkcijo.
V razdelku o sintaksi tega priročnika sem to kodo uporabil kot poenostavljeno različico paramskega bloka.
|_+_|V tem razdelku se bom osredotočil na CmdletBinding atribut del kode. Tukaj je, kako definirati atribut …
|_+_|V naslednjih 3 pododdelkih bom razpravljal o nekaterih pogostih argumentih, ki jih lahko definirate v CmdletBinding atribut.
Da se izognete dvomom, morate vse opredeliti Argumenti znotraj bloka () v atribut . Prav tako morate vse atribute ločiti z vejico (,), razen zadnjega Argumenti znotraj atribut .
Param. PowerShell DefaultParameterSetName Prepir
Ko razvijete funkcijo PowerShell, lahko vsebuje več parametrov, ki jih lahko uporabnik uporabi v istem ukazu. Poleg tega lahko ista funkcija PowerShell vsebuje drug niz parametrov, ki jih lahko uporabnik uporabi v drugem ukazu.
Vendar pa uporabnik ne more mešati parametrov v prvem nizu s parametri v drugem nizu.
Poleg tega razvijalec funkcij definira vse parametre, ki jih lahko uporabnik uporabi v istem ukazu z ParameterSetName prepir. The ParameterSetName argument je definiran znotraj atributa parametra (več o tem v naslednjem razdelku).
Posledica različnih naborov združenih parametrov je, da boste imeli različne ParameterSetName s.
Z različnimi ParameterSetName s defied v vašem bloku param, se lahko odločite, da definirate enega od ParameterSetName s kot privzeto. Tukaj uporabljate DefaultParameterSetName Prepir.
The DefaultParameterSetName Argument je opredeljen znotraj CmdletBinding atributni blok. Tukaj je primer…
|_+_|Nazadnje, da ohranimo naš format parametrov PowerShell, bom spodaj ponovno predstavil blok parametrov ...
|_+_|Param. PowerShell SupportsShouldProcess Prepir
To je še en argument, ki ga lahko definirate v CmdletBinding atribut . Kot DefaultParameterSetName Argument, SupportsShouldProcess Argument je neobvezen.
The SupportsShouldProcess Argument dodaja Potrdi in Kaj če skupni parametri funkcije.
Če želite dodati ta argument, dodajte vejico (,) na konec DefaultParameterSetName prepir. Nato dodajte vrstico – SupportsShouldProcess =$true ali $false.
S tem novim argumentom, vključenim, CmdletBinding atribut zdaj bo videti takole...
|_+_|Param. PowerShell HelpURI Prepir
Če poznate PowerShell Poišči pomoč Cmdlet, morda ste naleteli nanj Na spletu parameter. Ko tečeš Poišči pomoč z Na spletu parameter, PowerShell odpre spletno stran s pomočjo ukaza Cmdlet.
Če želite na primer odpreti spletno stran s pomočjo ukaza Out-File Cmdlet, zaženite spodnji ukaz ...
|_+_|Stran, ki jo odpre ta ukaz, je v funkciji definirana z HelpURI Prepir. Torej, če želite, da uporabniki dostopajo do spletne strani pomoči vaše funkcije, definirajte HelpURI Prepir.
Tukaj je primer…
|_+_|Zdaj bom ta zadnji argument vključil v CmdletBinding atribut . Tukaj je posodobljena koda ...
|_+_|Param. PowerShell Parameter atribut
V parametru PowerShell CmdletBinding Pododdelek atributov sem razpravljal o 3 argumentih, ki jih lahko vključite v CmdletBinding Atributni blok.
Kot ste videli, CmdletBinding Atributni blok je edini atribut, definiran zunaj bloka parametrov.
V tem pododdelku boste izvedeli o atributu parametra. Poleg tega boste izvedeli tudi o pogostih argumentih, ki jih lahko dodate temu atributu.
spremenjen e-poštni naslov vdrtega računa netflix
Kot ste morda razbrali iz primerov, ki so že uporabljeni v tem priročniku, atribut parametra definira argumente, ki nadzorujejo obnašanje parametra PowerShell.
Atribut parametra lahko definirate tako, da v blok [] zaprete besedo Parameter, ki ji sledijo () oklepaji. Tukaj je primer…
|_+_|Če nadaljujemo, MORATE definirati vse argumente atributa parametra v bloku ().
V naslednjih pododdelkih razdelka PowerShell Parameter Parameter Attribute bom predstavil in pojasnil pogoste argumente, ki jih lahko definirate v atributu parametra.
Param. PowerShell ParameterSetName Prepir
Ko sem razložil DefaultParameterSetName sem predstavil prej v tem priročniku ParameterSetName Prepir. Ta argument lahko uporabite za paketne ali skupinske parametre, ki jih lahko uporabnik zažene v istem ukazu.
Na primer, če želite definirati a ParameterSetName poklical ParameterSetName1 , vnesite spodnjo kodo v blok Parameter Attribute ().
|_+_|Ko predstavim to posodobljeno kodo, bo blok parametrov moje vzorčne kode zdaj videti takole.
|_+_|Če prinesem nazaj CmdletBinding atributa, bo moja vzorčna koda parametrov PowerShell zdaj videti takole ...
|_+_|Param. PowerShell Obvezno Prepir
Lahko uporabite Obvezno argument za določitev, ali je parameter obvezen ali neobvezen. The Obvezno argument sprejme vrednost $true ali $false – $true pomeni zahteva, $false, ni potrebno.
Poleg tega je Obvezno argument ni obvezen. Če pa ta argument ni definiran, bo parameter obravnavan kot neobvezen.
Za opredelitev Obvezno Argument, dodajte spodnjo kodo v blok Parameter Attribute ...
|_+_|Končno, če vključim Obvezno Kodo argumenta moji kodi parametrov PowerShell, zdaj bom imel ...
|_+_|Param. PowerShell Položaj Prepir
The Položaj Argument atributa parametra določa položaj parametra. Vrednost je celo število, ki se začne z 0 (nič).
Korist od Položaj Argument je omogočiti uporabnikom, da zaženejo funkcijo z uporabo položaja parametrov. Natančneje, ko definirate Položaj Argument, uporabnik lahko vnese vrednosti za vsak parameter v ukazno vrstico, ne da bi določil parameter.
PowerShell bo nato dodelil vsako vrednost v ukazni vrstici glede na položaj parametra.
Na primer, Get-ChildItem Cmdlet ima parameter, imenovan Pot (s položajem 0). Cmdlet ima tudi drug parameter, Filter (s položajem 1).
Privzeto, če zaženem Get-ChildItem ukaz, moram vključiti imena parametrov, preden dodam njihove vrednosti. Oglejte si spodnji ukaz …
|_+_|V tem ukazu sem poklical parametre in nato določil njihove vrednosti.
Ker pa poznam položaje teh dveh parametrov, lahko dodam vrednosti v njihova položaja, ne da bi izrecno poklical parametre. Nato bom spremenil svoj ukaz, kot je prikazano spodaj ...
Zakaj se moj Google Račun neprestano zaustavlja|_+_|
Očitno mi to prihrani čas! Če pa gledate dolgo kodo PowerShell, lahko to povzroči nekaj zmede.
Ukaz daje enak rezultat v PowerShell ...
PowerShell bo samodejno dodelil vrednosti na položajih parametrom na podlagi njihovih Položaj Prepir.
Nadaljujemo, takole definirate Položaj Prepir…
|_+_| V tem primeru je moj položaj parametra 0 (nič). Ko bom definiral svoj naslednji parameter, bo na položaju 1 itd. Ne morete imeti dveh parametrov na istem mestu. Kasneje v priročniku se boste naučili, kako dodati en parameter na isti položaj, vendar drugačna imena nabora parametrov.Zdaj bom ta argument dodal svoji vzorčni kodi ...
|_+_|Param. PowerShell ValueFromPipeline Prepir
Drugo pogosto uporabljeno povečanje parametrov je ValueFromPipeline Prepir. Kot pove že ime, ta argument določa, ali parameter sprejema vrednosti iz cevovoda.
Tako vi definirate ta argument ...
|_+_|Če dodam ta nov argument svoji kodi, bo videti takole ...
|_+_|Obstaja še en argument, ki se imenuje ValueFromPipelineByPropertyName . Če želite prebrati o tem argumentu, obiščite about_Functions_Advanced_Parameters .
Param. PowerShell Sporočilo pomoči Prepir
Ta argument lahko uporabite za določitev sporočila, ki uporabnikom pokaže, kako uporabljati parameter. Za opredelitev a Sporočilo pomoči Argument za parameter, uporabite kodo, podobno spodnji ...
|_+_|In tukaj je zdaj moja posodobljena koda ...
|_+_|Do sedaj sem v tem razdelku obravnaval 2 atributa parametrov PowerShell – CmdletBinding in Parameter . Poleg tega sem razpravljal tudi o pogostih argumentih, ki jih lahko definirate za te atribute.
V preostalih 3 pododdelkih tega razdelka vas bom naučil 3 pogosteje uporabljene atribute parametrov PowerShell. Vendar ti 3 atributi ne zahtevajo, da definirate argumente.
Param. PowerShell vzdevek atribut
Atribut vzdevka se uporablja za določanje vzdevkov parametra. Kot ste morda uganili, lahko namesto parametra uporabite vzdevek parametra PowerShell.
Preden vam pokažem, kako definirati atribut vzdevka za parameter, naj vam najprej pokažem, kako najti vzdevke vseh Cmdletov in funkcij v vašem računalniku.
Če želite navesti vse vzdevke za ukazne ukaze in funkcije, zaženite spodnji ukaz
|_+_|To bo navedlo vse vzdevke ...
Prehajamo na vzdevek Atribut, da ga definirate za parameter parametra PowerShell, uporabite kodo, podobno spodnji…
|_+_| V tem primeru je FP vzdevek za parameter.Če to dodam svoji kodi, bo posodobljena različica videti takole ...
|_+_|Param. PowerShell Podpira nadomestne znake atribut
Ta atribut parametra parametra določa, ali parameter sprejema nadomestne znake. Tukaj je, kako definirate ta atribut ...
|_+_|Param. PowerShell ValidateNotNullOrEmpty Validacijski atribut
Kot večina atributov, ki so že obravnavani v tem priročniku, ga tudi ime tega atributa razkriva. To je validacijski atribut.
Ko definirate ta atribut, parameter NE bo sprejel ničelne ($null) vrednosti. Poleg tega ne bo sprejel prazne vrednosti ().
Če uporabnik vnese $null ali , bo funkcija izdala napako. Če želite definirati ta atribut, vnesite spodnjo kodo ...
|_+_|Končno bom posodobil svojo kodo z zadnjima dvema atributoma ...
|_+_|Ime parametra PowerShell
Ko definirate vse atribute in argumente parametra, morate dodati ime parametra. Parameter parametra PowerShell je definiran kot spremenljivka – z znakom za dolar ($), ki mu sledi ime parametra.
Po želji lahko vnesete tudi vrsto podatkov za parameter. V 2. razdelku tega priročnika sem razpravljal o različnih vrstah parametrov PowerShell.
Tukaj je opisano, kako definirate parameter, ki ga lahko sprejme vrvica vrsto podatkov.
|_+_|Tukaj je moj posodobljen primer kode ...
|_+_|Kako definirati en parameter PowerShell v več nizih parametrov
Če ste novi pri kodiranju funkcij PowerShell, obstaja velika verjetnost, da boste padli v skušnjavo, da bi en parameter definirali večkrat.
Eden od razlogov, zakaj boste morda želeli imeti parameter večkrat, je, če se parameter uporablja v več naborih parametrov (več naborov parametrov).
Če želite to spodbuditi, recimo, da razvijate funkcijo PowerShell, ki ima a Pot parameter. Vendar pa imate 2 ParameterSetNames, ki zahtevata parameter Path.
Večina ljudi, ki so novi v skriptiranju PowerShell, bo verjetno opredelila parametre, ki so prikazani spodaj ...
|_+_|Če določite parametre, kot je prikazano zgoraj, boste prejeli sporočilo o napaki. Za preizkus te teorije bom kodo kopiral v PowerShell ISE.
Torej, kako to popraviš? Rešitev je v definiranju dveh atributov parametrov in njihovih argumentov – vključno z njihovimi ParameterSetNames.
Nato na koncu obeh atributov parametra definirajte eno samo ime parametra, ki je skupno obema atributoma parametra. V prejšnjem primeru bom odstranil prvo ime parametra in pustil zadnjega.
|_+_|Zdaj, če kopiram to kodo v PowerShell ISE, bo v redu.
V tem primeru upoštevajte, da so argumenti parametrov za oba atributa parametrov lahko popolnoma različni. Poleg tega lahko definirate poljubno število atributov parametrov.Primeri parametrov PowerShell
V tem zadnjem razdelku vodnika bom dal primer parametrov SysAdmin PowerShell v resničnem življenju.
Medtem ko sem pisal ta vodnik, sem začel razvijati skript/funkcijo PowerShell, da bi dobil velikost mape in število datotek. Tukaj je param del funkcije ...
android pc suite za Windows 10|_+_|
V naslednjih nekaj pododdelkih tega razdelka bom razložil različne elemente parametra. Nazadnje zadnji razdelek uvaja funkcijski blok in v funkcijo doda blok parametrov.
Da boste lažje sledili vrsticam v kodi, navedeni v naslednjih podrazdelkih, prenesite PowerShellParamExample.zip. Nato razpakirajte datoteko in odprite datoteko .ps1 v PowerShell ISE.
ParameterSetName Primer parametra PowerShell
Moja primerna koda parametrov PowerShell ima tri imena nabora parametrov – DisplayResult , ExportTxt in IzvoziCSV . Uporabil sem ta imena, da bi lažje prepoznal, kaj počnejo.
V uvodu tega razdelka sem omenil, da bo funkcija, ki jo gradim s to kodo parametra, prikazala velikost mape in število datotek za vsako podmapo v določeni mapi.
Zato trije ParameterSetNames ponujajo uporabniku možnost prikaza rezultatov na ukazni mizi PowerShell. Uporabnik ima lahko tudi možnost izvoza rezultata v besedilno datoteko ali datoteko CSV.
Poleg tega vsak ParameterSetName definirati vse parametre, ki jih uporabnik lahko pokliče v enem ukazu. Na podlagi te ideje bo imela funkcija, ki jo gradim, tri ukazne možnosti ali sintakse.
To idejo bom razširil v naslednjih pododdelkih in primerih.
CmdletBinding Lastnost In DefaultParameterSetName Primeri argumentov
V prejšnjih razdelkih tega priročnika ste naleteli na CmdletBinding atribut. Poleg tega ste naleteli tudi na enega od njegovih argumentov – DefaultParameterSetName .
The DefaultParameterSetName Argument se uporablja za definiranje privzetega nabora parametrov, ki ga pokliče funkcija. V tem primeru je privzeto ime nabora parametrov DisplayResult .
The DefaultParameterSetName je navedena v 1. vrstici kode.
PowerShell bo poskušal uporabiti nabor parametrov, ki ga je deklarirala DefaultParameterSetName če ne more določiti, kateri nabor parametrov naj uporabi. Če pa nastavite obvezne parametre, se lahko izognete tej težavi.
V vsakem primeru ni škode, če navedete ime privzetega nabora parametrov.
FolderPath Primer parametra niza
Tukaj se zabava začne! The FolderPath parameter se uporablja za vnos poti do mape, funkcija bo dobila velikost svojih podmap – in preštela število datotek v vsaki podmapi.
To je parameter niza. To pomeni, da sprejema kateri koli niz kot vhod.
Ena vznemirljiva lastnost FolderPath parameter je, da je skupen za 3 imena nizov parametrov. Prej v tem članku sem razložil izziv, s katerim se lahko v tej situaciji soočijo razvijalci novih skriptov PowerShell.
Za razglasitev FolderPath parameter v imenih treh naborov parametrov, sem ustvaril tri atribute parametrov.
Prvi atribut parametra je med vrsticama 5 in 11. Poleg tega ima ta prvi atribut parametra več argumentov.
Vendar pa bi rad, da bodite še posebej pozorni na ParameterSetName prepir - DisplayResult .
Drugič, med vrsticama 12 in 18 sem razglasil še en atribut parametra z a ParameterSetName argument ExportTxt .
Končno sem med vrsticama 19 in 25 razglasil tretji atribut parametra z a ParameterSetName argument IzvoziCSV .
Poleg tega, če opazite, sem za razliko od deklariranja 3 atributov parametrov razglasil enega vzdevek , in ValidateNotNullOrEmpty lastnosti. Te atribute najdete v vrsticah 26 in 27.
Končno sem tik pod vsemi atributi in njihovimi argumenti vključil ime parametra – FolderPath . Ime parametra je v vrstici 28.
V zadnjem pododdelku tega razdelka boste videli, kako funkcija prikaže ta parameter v 3 sintaksi ukazov.DisplayResult , ExportTxt in IzvoziCSV Primer parametra preklopa
Iz 29. vrstice kode parametrov sem razglasil še en niz atributov parametrov in njihovih argumentov.
Najprej med vrsticama 29 in 37 razglasim atribute parametrov in argumente za DisplayResult parameter.
Nato med vrsticama 38 in 47 razglasim drug parameter, ki se imenuje ExportTxt .
Končno sem med vrsticama 48 in 57 razglasil IzvoziCSV parameter.
3 parametri, ki sem jih opisal v tem razdelku, so vsi Preklopi parametrov. Kot že veste, to pomeni, da parametri ne zahtevajo nobenega vnosa od uporabnika.
Ko uporabnik izbere kateri koli parameter, funkcija spremeni način prikaza rezultatov.
Kako uporabljati parameter PowerShell v funkciji PowerShell
V tem pododdelku želim v moj primer kode uvesti funkcijski blok PowerShell.
Sintaksa funkcijskega bloka PowerShell je ...
|_+_|Za zadnji primer v tem priročniku bom blok parametrov PowerShell v sintaksi funkcije zamenjal s svojo kodo parametra iz zadnjega podrazdelka. Poleg tega bom funkcijo zamenjal z Get-FolderSizeFileCount , ime funkcije.
Končna funkcija bo zdaj videti takole ...
|_+_| V tem primeru so bloki Začetek {}, Proces {} in Konec {} prazni.Preizkušanje parametrov PowerShell v funkciji PowerShell
V tem zadnjem razdelku bom preizkusil parametre v funkciji, ki sem jo ustvaril v zadnjem razdelku.
Če jo želite preizkusiti sami, lahko kodo prenesete s klikom na to povezavo – Get-FolderSizeFileCount.zip. Nato razpakirajte datoteko zip.
Ko razpakirate datoteko, odprite PowerShell in zaženite spodnji ukaz:
|_+_| Spremenite na celotno pot do razpakirane datoteke.Ko zaženete ukaz, boste prejeli opozorilno sporočilo. Ob pozivu za sporočilo vnesite R in pritisnite tipko enter na tipkovnici.
Ko je modul uvožen, na isti konzoli PowerShell zaženite spodnji ukaz:
|_+_|Tukaj je rezultat ukaza ...
tablični računalnik ni povezan z internetom
Želim vam pokazati razdelek SINTAKSA na strani pomoči moje funkcije. Na zgornjem posnetku zaslona lahko zaženete ukaz Get-FolderSizeFileCount v treh različnih ukazih:
|_+_|Prva stvar, ki jo je treba omeniti, je, da imajo tri sintakse FolderPath parameter niza. Če preberete ta priročnik, boste vedeli zakaj.
Poleg tega boste opazili, da ima prva sintaksa DisplayResult tudi preklopni parameter. Končno, v drugi in tretji sintaksi, imate IzvoziCSV , in ExportTxt preklopni parameter oz.
Poleg FolderPath , in IzvoziCSV parametri in ExportTxt parametrov v drugi in tretji sintaksi, imajo tudi ReportPath parameter niza. Tega parametra nisem omenil, ker je koda deklaracije podobna FolderPath kodo, z nekaj manjšimi razlikami. The ReportPath se uporablja za določitev poti, po kateri bo funkcija shranila poročila o besedilu in datoteki CSV.To je to – izčrpen vodnik o parametrov PowerShell! Upam, da vam je bilo v pomoč?
Če se vam zdi v pomoč, vljudno glasujte da na spodnje vprašanje Ali je bila ta objava koristna.
Lahko pa postavite vprašanje, pustite komentar ali pošljete več povratnih informacij z obrazcem za pustite odgovor na koncu te strani.
Nazadnje, za več PowerShell tech S con obiščite našo stran z navodili za Windows PowerShell. Morda vam bo v veliko pomoč tudi naša stran Delo od doma.
