Параметър на PowerShell: синтаксис, типове, атрибути, аргументи и примери

15 юни 2021 г 16760 Изгледи Параметър на PowerShell: синтаксис, типове, атрибути, аргументи и примери

Разработчиците на скриптове на PowerShell използват блок Powershell Param, за да добавят параметри към разширени функции. Всеки, който изпълнява функцията, има достъп до параметри, добавени с PowerShell Param.





Освен това, освен параметрите, добавени към функция с блока Param, Windows PowerShell автоматично добавя общи параметри.



Това ръководство обхваща синтаксиса на Powershell Param, типовете параметри на Powershell, техните атрибути и аргументи. Той също така дава някои примери за това как да използвате блока Param за добавяне на параметри към скрипт или функция.

Разгледайте темите на публикациите



Синтаксис на блок с параметри на PowerShell

Синтаксис на блок с параметри на PowerShell

Синтаксисът на PowerShell Param е...



|_+_|

За да добавите параметър към функция, започнете с думата Спри се , последвано от блока на параметъра, (). Ето една проста форма на параметър блок...

|_+_| В CmdletBinding атрибутът не е задължителен и е единственият атрибут, дефиниран извън блока param. Повече за това по-късно в ръководството

В блока Param – param () – ще дефинирате атрибутите на параметрите и техните аргументи. Освен това, атрибут на параметър е затворен в блок [()].



В кода на синтаксиса по-горе удебелих всички аргументи на параметрите. Има много повече аргументи за параметри – тези в синтаксиса са само за илюстративни цели и по никакъв начин не са изчерпателни.

В блока с параметри ще дефинирате аргументи на параметри, разделени със запетаи. Пример за атрибут на PowerShell Param е параметър атрибут.



zte zmax pro персонализирани roms

Освен това, пример за аргумент param е задължителен аргумент. Друг пример за аргумент param е ParameterSetName .

Накрая ще дефинирате името на параметъра. Освен това ще посочите и типа данни на параметъра.

В следващия раздел ще обсъдя често срещаните типове параметри на PowerShell. След това третият раздел обхваща общи атрибути на параметри и техните аргументи.

И накрая, в последния раздел на това ръководство ще дам реален пример за SysAdmin за PowerShell Param. Разделът също така ще даде примери за това как да използвате параметърния блок в разширена функция.

Типове параметри на PowerShell

Типове параметър на PowerShell

Най-често срещаните типове параметри, които можете да зададете, са низ или превключвател параметри. Освен това можете също да дефинирате международен , bool , Време за среща или типове параметри char.

В този раздел ще обясня някои от тези типове параметри. Ще дам също някои примери как да ги дефинирате в параметър блок.

Параметр на PowerShell низ Параметър

Когато създавате параметри на PowerShell, е вероятно да създадете a низ параметър. А низ параметърът приема всяка стойност на низ.

В Windows PowerShell низът може да бъде числа, думи или знаци. По-конкретно, всичко, което декларирате в двойни или единични кавички, е низ.

В PowerShell типът на обекта на низ е System.String .

За да декларирате параметър на PowerShell като параметър на низ, оградете думата преди името на параметъра низ в скоби. Ето един пример…

|_+_|

Параметр на PowerShell международен Параметър

Ан международен типът данни е 32-битово цяло число със знак. На английски, an международен е число, например 1, 2 или 3.

За разлика от а низ параметър тип данни, който може да приема всякакъв тип данни, an международен параметърът е много предписващ.

Ако дефинирате an международен параметър, параметърът може да приема само числа. Освен това, ако въведете думи като стойност за международен параметър, PowerShell ще изведе съобщение за грешка.

Преди да ви покажа как да дефинирате PowerShell Param международен параметър, ето общ пример за това как да дефинирате тип данни int...

|_+_|

Ако стартирам кода в PowerShell, той ще се върне 123 .

Параметър на PowerShell int

Напротив, ако заменя, 123 с това е int, PowerShell ще изведе съобщение за грешка.

|_+_|

Сега, когато сте имали международен Кратък курс за тип данни, за да създадете PowerShell Param международен параметър, наречен номер, ето кода...

|_+_|

Това ще принуди потребителите на вашия скрипт или функция да предоставят правилния тип данни.

Параметр на PowerShell Време за среща Параметър

Като международен параметър, а Време за среща параметърът също е много предписващ за типа вход, който приема. Както подсказва името, Време за среща параметърът ще приема само въвеждане във формат дата и час.

Ако искате да дефинирате параметър на PowerShell, който ще приема само дати, използвайте примерния код по-долу...

|_+_|

В този пример, Въведете дата е името на параметъра. Освен това, Време за среща определя типа данни.

Параметр на PowerShell Превключете Параметър

В първите три подраздела на този раздел обсъдих типове параметри на PowerShell, които изискват въвеждане от потребител.

Въпреки това, има тип параметър PowerShell, който не изисква въвеждане от потребител. За разлика от другите типове параметри, a превключвател параметърът не изисква въвеждане от потребителя.

Начинът, по който дефинирате a превключвател параметърът е подобен на начина, по който дефинирате други типове параметри. Въпреки това, на мястото на превключвател , международен , или Време за среща , използвайте думата превключвател .

Например за дефиниране на параметър на PowerShell Превключете параметър, Експортиране на CSV , използвайте кода по-долу...

|_+_|

И накрая, за този раздел може да се чудите за приложението на превключвател параметри. Помислете за скрипт или функция на PowerShell, която може да показва резултати в конзолата на Powershell.

Може също да искате да дадете на потребителя възможност да експортира резултата в текстов файл или в CSV файл.

Един от начините за кодиране на функцията е да създадете 3 параметъра за превключване. След това потребителят може да избере един от параметрите, в зависимост от това как иска функцията да предостави резултата.

Този тип параметър не изисква от потребителя да въвежда вход. Чрез просто избиране на параметъра, функцията ще покаже съответно изхода.

Можете също да дефинирате други параметри на PowerShell с конкретни типове данни. За да научите за типовете данни на PowerShell, посетете тази връзка – Как да дефинирате типове данни на PowerShell .

Атрибути и аргументи на параметри на PowerShell

Атрибути и аргументи на параметри на PowerShell

В синтаксиса на параметрите на PowerShell на това ръководство намекнах, че параметърът на PowerShell има атрибути. Освен това посочих също, че всеки атрибут на параметър също има аргументи.

В този раздел ще обсъждам атрибутите на параметрите и техните аргументи.

За да обясня атрибутите на параметрите и техните аргументи, ще се позова на синтаксиса на PowerShell param, въведен в първия раздел на това ръководство.

|_+_|

Параметр на PowerShell CmdletBinding Атрибут

В CmdletBinding атрибутът обикновено се посочва преди блока param. Когато дефинирате CmdletBinding атрибут, PowerShell ще разпознае скрипта като разширена функция.

В раздела за синтаксис на това ръководство използвах този код като опростена версия на параметър блок.

|_+_|

В този раздел ще се съсредоточа върху CmdletBinding Атрибут част от кода. Ето как да дефинирате Атрибут …

|_+_|

В следващите 3 подраздела ще обсъдя някои от често срещаните аргументи, които можете да дефинирате в CmdletBinding атрибут.

За да избегнете съмнения, трябва да дефинирате всички Аргументи в блока () на Атрибут . Освен това ТРЯБВА да разделяте всички атрибути със запетая (,), с изключение на последния Аргументи в рамките на Атрибут .

Параметр на PowerShell DefaultParameterSetName Аргумент

Когато разработите функция PowerShell, тя може да съдържа множество параметри, които потребителят може да използва в една и съща команда. Освен това същата функция на PowerShell може да съдържа друг набор от параметри, които потребителят може да използва в друга команда.

Въпреки това, потребителят не може да смесва параметрите от първия набор с параметрите във втория набор.

Освен това, разработчикът на функции дефинира всички параметри, които потребителят може да използва в една и съща команда с ParameterSetName аргумент. В ParameterSetName Аргументът се дефинира в атрибута на параметъра (повече за това в следващия раздел).

Последствието от наличието на различни набори от групирани параметри е, че ще имате различни ParameterSetName с.

С различни ParameterSetName s defied във вашия блок за параметри, може да решите да дефинирате един от ParameterSetName s по подразбиране. Това е мястото, където използвате DefaultParameterSetName Аргумент.

В DefaultParameterSetName Аргументът се дефинира в рамките на CmdletBinding атрибутен блок. Ето един пример…

|_+_|

И накрая, за да запазя формата на нашия PowerShell param block, ще въведа отново параметърния блок по-долу...

|_+_|

Параметр на PowerShell Поддържа ТрябваПроцес Аргумент

Това е друг аргумент, който можете да дефинирате в CmdletBinding Атрибут . Като DefaultParameterSetName Аргумент, на Поддържа ТрябваПроцес Аргументът е незадължителен.

В Поддържа ТрябваПроцес Аргументът добавя Потвърдете и Какво ако общи параметри на функцията.

За да добавите този аргумент, добавете запетая (,) в края на DefaultParameterSetName аргумент. След това добавете реда - Поддържа ТрябваПроцес =$true или $false.

С включен този нов аргумент, CmdletBinding Атрибут сега ще изглежда така...

|_+_|

Параметр на PowerShell HelpURI Аргумент

Ако сте запознати с PowerShell Поискай помощ Cmdlet, може да сте попаднали на него Онлайн параметър. Когато тичаш Поискай помощ с Онлайн параметър, PowerShell отваря онлайн страницата за помощ на командата.

Например, за да отворите онлайн страницата за помощ на командлета Out-File, изпълнете командата по-долу...

|_+_|

Страницата, отворена от тази команда, се дефинира във функция от HelpURI Аргумент. Така че, ако искате потребителите да имат достъп до страницата за онлайн помощ на вашата функция, дефинирайте HelpURI Аргумент.

Ето един пример…

|_+_|

Сега ще включа този последен аргумент в CmdletBinding Атрибут . Ето актуализирания код...

|_+_|

Параметр на PowerShell Параметър Атрибут

В параметра на PowerShell CmdletBinding Подраздел за атрибути, обсъдих 3 аргумента, които можете да включите в CmdletBinding Атрибутен блок.

Както видяхте, CmdletBinding Атрибутният блок е единственият атрибут, дефиниран извън блока на параметрите.

В този подраздел ще научите за атрибута на параметъра. Освен това ще научите и за често срещаните аргументи, които можете да добавите към този атрибут.

Както може би сте заключили от примерите, които вече са използвани в това ръководство, атрибутът на параметъра дефинира аргументи, които контролират поведението на параметър на PowerShell.

Можете да дефинирате атрибута на параметъра, като затворите думата параметър, последвана от () скоби в блок []. Ето един пример…

|_+_|

Продължавайки нататък, ТРЯБВА да дефинирате всички аргументи на атрибута на параметъра в блока ().

В следващите подраздели на раздела за атрибут на параметър на PowerShell ще представя и обясня често срещаните аргументи, които можете да дефинирате в атрибута на параметъра.

Параметр на PowerShell ParameterSetName Аргумент

Когато обясних DefaultParameterSetName по-рано в това ръководство, представих ParameterSetName Аргумент. Можете да използвате този аргумент за групови или групови параметри, които потребителят може да изпълни в същата команда.

Например, за да дефинирате a ParameterSetName Наречен ParameterSetName1 , въведете кода по-долу в блока Параметър Атрибут ().

|_+_|

Когато представя този актуализиран код, параметърният блок на моя примерен код ще изглежда така..

|_+_|

Ако върна обратно CmdletBinding атрибут, моят примерен код за параметър на PowerShell сега ще изглежда така...

|_+_|

Параметр на PowerShell Задължителен Аргумент

Можете да използвате Задължителен аргумент, за да определите дали даден параметър е задължителен или незадължителен. В Задължителен Аргументът приема стойност $true или $false – $true означава изискване, $false, не се изисква.

Освен това, на Задължителен аргументът е по избор. Въпреки това, ако този аргумент не е дефиниран, параметърът ще се третира като незадължителен.

За да определите Задължителен Аргумент, добавете кода по-долу към блока Parameter Attribute...

|_+_|

И накрая, ако включа и Задължителен Аргументирайте кода към моя парамен код на PowerShell, сега ще имам...

използване на диска avast 100
|_+_|

Параметр на PowerShell позиция Аргумент

В позиция Аргументът на атрибута на параметъра определя позицията на параметъра. Стойността е цяло число, започващо от 0 (нула).

Ползата от позиция Аргументът е да позволи на потребителите да изпълняват функцията, използвайки позицията на параметрите. По-конкретно, когато дефинирате позиция Аргумент, потребителят може да въвежда стойности за всеки параметър в командния ред, без да посочва параметъра.

След това PowerShell ще присвои всяка стойност в командния ред според позицията на параметъра.

Например, на Get-ChildItem Cmdlet има параметър, наречен пътека (с позиция 0). Cmdlet също има друг параметър, Филтрирайте (с позиция 1).

По подразбиране, ако стартирам Get-ChildItem команда, трябва да включа имената на параметрите, преди да добавя техните стойности. Вижте командата по-долу...

|_+_|

В тази команда извиках параметрите и след това посочих техните стойности.

Аргумент за позиция на параметрите на PowerShell

Въпреки това, тъй като знам позициите на тези 2 параметъра, мога да добавя стойности в техните позиции, без изрично да извикам параметрите. След това ще променя моята команда, както е показано по-долу...

|_+_|

Очевидно това ми спестява време! Въпреки това, ако разглеждате дълъг код на PowerShell, това може да предизвика известно объркване.

Командата дава същия резултат в PowerShell...

PowerShell автоматично ще присвои стойностите в позициите на параметрите въз основа на техните позиция Аргумент.

Продължавайки, ето как дефинирате позиция Аргумент…

|_+_| В този пример позицията на моя параметър е 0 (нула). Когато дефинирам следващия си параметър, той ще бъде на позиция 1 и т.н. Не можете да имате два параметъра на една и съща позиция. По-късно в ръководството ще научите как да добавите един параметър на същата позиция, но различни ParameterSetNames.

Сега ще добавя този аргумент към моя примерен код...

|_+_|

Параметр на PowerShell ValueFromPipeline Аргумент

Друго често използвано увеличение на параметрите е ValueFromPipeline Аргумент. Както подсказва името, този аргумент определя дали параметърът приема стойности от конвейера.

Тя е как определяте този аргумент...

|_+_|

Ако добавя този нов аргумент към моя код, той ще изглежда така...

|_+_|

Има още един аргумент, наречен ValueFromPipelineByPropertyName . За да прочетете за този аргумент, посетете about_Functions_Advanced_Parameters .

Параметр на PowerShell HelpMessage Аргумент

Можете да използвате този аргумент, за да посочите съобщението, за да покажете на потребителите как да използват параметър. За да определите а HelpMessage Аргумент за параметър, използвайте код, подобен на този по-долу...

активирайте starz play на xbox 360
|_+_|

И ето сега моят актуализиран код...

|_+_|

Досега в този раздел обсъдих 2 параметра на PowerShell – CmdletBinding и Параметър . Освен това обсъдих и често срещаните аргументи, които можете да дефинирате за тези атрибути.

В останалите 3 подраздела на този раздел ще ви науча на 3 по-често използвани атрибута на параметрите на PowerShell. Тези 3 атрибута обаче не изискват да дефинирате аргументи.

Параметр на PowerShell Псевдоним Атрибут

Атрибутът псевдоним се използва за определяне на псевдоними на параметър. Както може би се досещате, вместо параметъра може да се използва псевдонимът на параметър на PowerShell.

Преди да ви покажа как да дефинирате атрибута alias за параметър, нека първо да ви покажа как да намерите псевдоними на всички команди и функции на вашия компютър.

За да изброите всички псевдоними за командлети и функции, изпълнете командата по-долу

|_+_|

Това ще изброи всички псевдоними...

Атрибут псевдоним на PowerShell

Преминавайки към Псевдоним Атрибут, за да дефинирате такъв за параметър на PowerShell, използвайте код, подобен на този по-долу...

|_+_| В този пример FP е псевдонимът на параметъра.

Ако добавя това към моя код, актуализираната версия ще изглежда така...

|_+_|

Параметр на PowerShell Поддържа заместващи карти Атрибут

Този атрибут param parameter определя дали даден параметър приема заместващи знаци. Ето как определяте този атрибут...

|_+_|

Параметр на PowerShell ValidateNotNullOrEmpty Атрибут за валидиране

Подобно на повечето атрибути, които вече са обхванати в това ръководство, името на този атрибут също го разкрива. Това е атрибут за валидиране.

Когато дефинирате този атрибут, параметърът НЯМА да приема стойност null ($null). Освен това, той няма да приеме празна () стойност.

Ако потребител въведе $null или , функцията ще изведе грешка. За да дефинирате този атрибут, въведете кода по-долу...

|_+_|

Накрая ще актуализирам кода си с последните 2 атрибута...

|_+_|

Име на параметър на PowerShell

След като сте дефинирали всички атрибути и аргументи на параметър, трябва да добавите името на параметъра. Параметърът на PowerShell се дефинира като променлива – със знак за долар ($), последван от името на параметъра.

Можете също така по избор да въведете тип данни за параметъра. В раздел 2 от това ръководство обсъдих различни типове параметри на PowerShell.

Ето как можете да дефинирате параметър, който може да приеме низ тип данни.

|_+_|

Ето моя пример за актуализиран код...

|_+_|

Как да дефинирате един параметър на PowerShell в множество набори от параметри

Как да дефинирате един параметър на PowerShell в множество набори от параметри

Ако сте нов в кодирането на функциите на PowerShell, има вероятност да изпаднете в изкушението да дефинирате един параметър няколко пъти.

Една от причините, поради които може да искате да имате параметър няколко пъти, е когато параметърът се използва в множество ParameterSetNames (множество набори от параметри).

За да управлявате този дом, да кажем, че разработвате функция PowerShell, която има пътека параметър. Имате обаче 2 ParameterSetNames, които изискват параметъра Path.

Повечето хора, които са нови в скриптовете на PowerShell, вероятно ще дефинират параметрите, показани по-долу...

|_+_|

Ако дефинирате параметрите, както е показано по-горе, ще получите съобщение за грешка. За да тествам тази теория, ще копирам кода в PowerShell ISE.

Как да дефинирате един параметър на PowerShell в множество набори от параметри

И така, как да поправите това? Решението е да се дефинират 2 атрибута на параметъра и техните аргументи – включително техните ParameterSetNames.

След това, в края на двата атрибута на параметъра, дефинирайте едно име на параметър, което е общо за двата атрибута на параметъра. В предишния пример ще премахна името на първия параметър и ще оставя последния.

|_+_|

Сега, ако копирам този код в PowerShell ISE, ще бъде наред.

В този пример имайте предвид, че аргументите на параметрите и за двата атрибута на параметъра могат да бъдат напълно различни. Освен това можете да дефинирате толкова атрибути на параметри, колкото искате.

Примери за параметри на PowerShell

Примери за параметри на PowerShell

В този последен раздел от ръководството ще дам реален пример за параметри на SysAdmin PowerShell.

Докато пишех това ръководство, започнах да разработвам скрипт/функция на PowerShell, за да получа размера на папката и броя на файловете. Ето частта от параметрите на функцията...

|_+_|

В следващите няколко подраздела на този раздел ще обясня различните елементи на param. И накрая, последният раздел въвежда функционален блок и добавя параметърния блок към функцията.

За да ви улесни да следвате редовете на кода, посочен в следващите подраздели, изтеглете PowerShellParamExample.zip . След това разархивирайте файла и отворете .ps1 файла в PowerShell ISE.

ParameterSetName Пример за параметър на PowerShell

Моят примерен код за параметър PowerShell има три ParameterSetNames – DisplayResult , ExportTxt и Експортиране на CSV . Използвах тези имена, за да улесня да идентифицирам какво правят.

Във въведението на този раздел споменах, че функцията, която изграждам с този параметър код, ще показва размера на папката и броя на файловете за всяка подпапка в определена папка.

Следователно трите ParameterSetNames предлагат на потребителя опцията да показва резултати в конзолата PowerShell. Като алтернатива, потребителят има опцията да експортира резултата в текстов файл или CSV файл.

Освен това всеки ParameterSetName дефинира всички параметри, които потребителят може да извика с една команда. Въз основа на тази идея, функцията, която изграждам, ще има три командни опции или синтаксиса.

идентификацията на обаждащия се на Samsung е спряла

Ще разширя тази идея в следващите подраздели и примери.

CmdletBinding Атрибут И DefaultParameterSetName Примери за аргументи

В предишните раздели на това ръководство се натъкнахте на CmdletBinding Атрибут. Освен това попаднахте и на един от аргументите му – DefaultParameterSetName .

В DefaultParameterSetName Аргументът се използва за дефиниране на набора от параметри по подразбиране, който функцията извиква. В този пример името на набора от параметри по подразбиране е DisplayResult .

В DefaultParameterSetName е деклариран в ред 1 от кода.

PowerShell ще се опита да използва набора от параметри, деклариран от DefaultParameterSetName ако не може да определи кой набор от параметри да използва. Въпреки това, ако зададете задължителни параметри, можете да избегнете този проблем.

Във всеки случай няма нищо лошо при декларирането на име на набор от параметри по подразбиране.

FolderPath Пример за параметър на низ

Тук започва забавлението! В FolderPath параметърът се използва за въвеждане на пътя на папката, функцията ще получи размера на своите подпапки - и ще преброи броя на файловете във всяка подпапка.

Това е параметър на низ. Това означава, че приема всеки низ като вход.

Една вълнуваща характеристика на FolderPath параметърът е, че е общ за 3-те имена на набор от параметри. По-рано в тази статия обясних предизвикателството, пред което могат да се сблъскат разработчиците на нови PowerShell скриптове в тази ситуация.

За да декларирате FolderPath параметър в трите имена на набора от параметри, създадох три атрибута на параметри.

Първият атрибут на параметъра е между редове 5 и 11. Освен това този атрибут на първи параметър има множество аргументи.

Искам обаче да обърнете специално внимание на ParameterSetName аргумент - DisplayResult .

Пример за параметър на низ на FolderPath

Второ, между редове 12 и 18 декларирах друг атрибут на параметър с a ParameterSetName извикан аргумент ExportTxt .

Накрая, между редове 19 и 25, декларирах трети атрибут на параметър с a ParameterSetName извикан аргумент Експортиране на CSV .

Пример за параметър на низ на FolderPath

Освен това, ако забележите, за разлика от декларирането на 3 атрибута на параметъра, аз декларирах единичен Псевдоним , и ValidateNotNullOrEmpty атрибути. Тези атрибути могат да бъдат намерени в редове 26 и 27.

Пример за параметър на низ на FolderPath

Накрая, точно под всички атрибути и техните аргументи, включих името на параметъра – FolderPath . Името на параметъра е в ред 28.

Пример за параметър на низ на FolderPathВ последния подраздел на този раздел ще видите как функцията показва този параметър в 3 командни синтаксиса.

DisplayResult , ExportTxt И Експортиране на CSV Пример за параметър за превключване

От ред 29 на кода на параметрите декларирах друг набор от атрибути на параметри и техните аргументи.

Първо, между редове 29 и 37, декларирам атрибутите и аргументите на параметрите за DisplayResult параметър.

След това, между редове 38 и 47, декларирам друг параметър, наречен ExportTxt .

Пример за превключване на DisplayResult, ExportTxt и ExportCSV

Накрая, между редове 48 и 57, обявих Експортиране на CSV параметър.

Трите параметъра, които описах в този раздел, са всички Превключете параметри. Както вече знаете, това означава, че параметрите не изискват никакво въвеждане от потребителя.

Когато потребител избере някой от параметъра, функцията променя начина, по който показва резултатите.

Как да използвате PowerShell Param във функция PowerShell

В този подраздел искам да представя функционалния блок PowerShell в моя примерен код.

Синтаксисът на функционален блок PowerShell е...

|_+_|

За последния пример в това ръководство ще заменя параметърния блок на PowerShell в синтаксиса на функцията с моя парамен код от последния подраздел. Освен това ще заменя функцията с Get-FolderSizeFileCount , името на функцията.

Окончателната функция сега ще изглежда така...

|_+_| За този пример блоковете Начало {}, Процес {} и Край {} са празни.

Тестване на параметрите на PowerShell във функцията PowerShell

В този последен раздел ще тествам параметрите във функцията, която създадох в последния раздел.

Ако искате да го тествате сами, можете да изтеглите кода, като щракнете върху тази връзка – Get-FolderSizeFileCount.zip . След това разархивирайте zip файла.

След като разархивирате файла, отворете PowerShell и изпълнете командата по-долу:

|_+_| Променете на пълния път към разархивирания файл.

Когато изпълните командата, ще получите предупредително съобщение. При подкана за съобщение въведете Р и натиснете клавиша enter на клавиатурата си.

Тестване на параметрите на PowerShell във функцията PowerShell

След като модулът бъде импортиран, на същата конзола PowerShell, изпълнете командата по-долу:

|_+_|

Ето резултата от командата...

Това, което искам да ви покажа, е разделът SYNTAX на помощната страница на моята функция. От екранната снимка по-горе можете да изпълните командата Get-FolderSizeFileCount в 3 различни команди:

|_+_|

Първото нещо, което трябва да се отбележи е, че трите синтаксиса имат FolderPath параметър на низ. Ако прочетете това ръководство, ще разберете защо.

Освен това ще забележите, че първият синтаксис има DisplayResult параметър за превключване. И накрая, във втория и третия синтаксис имате Експортиране на CSV , и ExportTxt параметър за превключване съответно.

В допълнение към FolderPath , и Експортиране на CSV параметри и ExportTxt параметри във втория и третия синтаксис съответно, те също имат ReportPath параметър на низ. Не споменах този параметър, защото кодът на декларацията е подобен на FolderPath код, с някои малки разлики. В ReportPath се използва за определяне на пътя, по който функцията ще запази текстовите и CSV файловите отчети.

Това е всичко – изчерпателно ръководство за параметрите на PowerShell! Надявам се, че ви е било полезно?

Ако ви е било полезно, любезно гласувайте да до въпроса Полезна ли е тази публикация по-долу.

Като алтернатива можете да зададете въпрос, да оставите коментар или да предоставите повече обратна връзка с формуляра за отговор, който се намира в края на тази страница.

И накрая, за повече PowerShell tech S зони, посетете нашата страница с инструкции за Windows PowerShell. Може също да намерите нашата страница „Работа от дома“ за много полезна.

Препратки и допълнителна литература

  1. Как да дефинирате типове данни на PowerShell
  2. about_Functions_Advanced_Parameters
  3. about_Functions_CmdletBindingAttribute