Paràmetre de PowerShell: sintaxi, tipus, atributs, arguments i exemples
Els desenvolupadors d'scripts de PowerShell utilitzen el bloc Powershell Param per afegir paràmetres a les funcions avançades. Qualsevol persona que executi la funció pot accedir als paràmetres afegits amb PowerShell Param.
A més, a més dels paràmetres afegits a una funció amb el bloc Param, Windows PowerShell afegeix automàticament Common Parameters .
Aquesta guia cobreix la sintaxi de Powershell Param, els tipus de Powershell Parameters, els seus atributs i arguments. També ofereix alguns exemples de com utilitzar el bloc Param per afegir paràmetres a un script o funció.
Navega per temes de publicació
- Sintaxi d'un bloc de paràmetres de PowerShell
- Tipus de paràmetres de PowerShell
- Atributs i arguments dels paràmetres de PowerShell
- Com definir un paràmetre de PowerShell en diversos conjunts de paràmetres
- Exemples de paràmetres de PowerShell
- ParameterSetName Exemple de paràmetres de PowerShell
- Exemples d'atribut CmdletBinding i d'arguments DefaultParameterSetName
- Exemple de paràmetre de cadena FolderPath
- Exemple de paràmetres de commutació DisplayResult, ExportTxt i ExportCSV
- Com utilitzar PowerShell Param en una funció de PowerShell
- Prova els meus paràmetres de PowerShell a la funció PowerShell
- Referències i lectura addicional
Sintaxi d'un bloc de paràmetres de PowerShell
La sintaxi de PowerShell Param és...
|_+_|
Per afegir un paràmetre a afunction , comença amb la paraula Atura , seguit del bloc de paràmetres, (). Aquí teniu una forma senzilla d'un bloc de paràmetres...
|_+_| El CmdletBinding l'atribut és opcional i és l'únic atribut definit fora del bloc de param. Més sobre això més endavant a la guiaDins del bloc Param – param () – definireu els atributs del paràmetre i els seus arguments. A més, un atribut de paràmetre està inclòs en un bloc [()].
Al codi de sintaxi anterior, vaig posar en negreta tots els arguments dels paràmetres. Hi ha molts més arguments de paràmetre: els de la sintaxi només tenen finalitats il·lustratives i no són de cap manera exhaustius.
Dins del bloc de paràmetres, definireu els arguments dels paràmetres, separats per comes. Un exemple d'atribut PowerShell Param és el paràmetre atribut.
A més, un exemple d'argument param és el obligatòria argument. Un altre exemple d'argument de param és ParameterSetName .
Finalment, definireu el nom del paràmetre. A més, també especificareu el tipus de dades del paràmetre.
A la següent secció, parlaré dels tipus comuns de paràmetres de PowerShell. A continuació, la secció tres tracta els atributs de paràmetres comuns i els seus arguments.
Finalment, a l'última secció d'aquesta guia, donaré un exemple de SysAdmin de la vida real d'un PowerShell Param. La secció també donarà exemples de com utilitzar el bloc de paràmetres en una funció avançada.
Tipus de paràmetres de PowerShell
Els tipus de paràmetres més comuns que podeu establir són corda o interruptor paràmetres. A més, també pots definir int , bool , DateTime o tipus de paràmetres char.
En aquest apartat explicaré alguns d'aquests tipus de paràmetres. També donaré alguns exemples de com definir-los en un bloc de param.
Param. de PowerShell Corda Paràmetre
Quan creeu paràmetres de PowerShell, és probable que creeu un corda paràmetre. A corda El paràmetre accepta qualsevol valor de cadena.
A Windows PowerShell, una cadena pot ser números, paraules o caràcters. Concretament, qualsevol cosa que declareu entre cometes dobles o simples és una cadena.
A PowerShell, el tipus d'objecte d'una cadena és System.String .
Per declarar un paràmetre de PowerShell com a paràmetre de cadena, abans del nom del paràmetre, afegiu la paraula corda entre parèntesis. Aquí teniu un exemple...
|_+_|Param. de PowerShell int Paràmetre
An int el tipus de dades és un nombre enter amb signe de 32 bits. En anglès, an int és un nombre, per exemple 1, 2 o 3.
A diferència d'a corda paràmetre tipus de dades que pot prendre qualsevol tipus de dades, a int el paràmetre és molt normatiu.
Si definiu un int paràmetre, el paràmetre només pot acceptar números. A més, si introduïu paraules com a valor per a int paràmetre, PowerShell llançarà un missatge d'error.
Abans de mostrar-vos com definir un PowerShell Param int paràmetre, aquí teniu un exemple general de com definir un tipus de dades int...
|_+_|Si executo el codi a PowerShell, tornarà 123 .
Al contrari, si substitueixo, 123 amb això és un int, PowerShell llançarà un missatge d'error.
|_+_|
Ara que has tingut un int Curs intensiu de tipus de dades, per crear un PowerShell Param int paràmetre anomenat número, aquí teniu el codi...
|_+_|Això obligarà els usuaris del vostre script o funció a proporcionar el tipus de dades adequat.
Param. de PowerShell DateTime Paràmetre
Com un int paràmetre, a DateTime El paràmetre també és molt normatiu del tipus d'entrada que accepta. Com el seu nom indica, el DateTime El paràmetre només acceptarà entrades de format de data i hora.
Si voleu definir un paràmetre de PowerShell que només accepti dates, utilitzeu el codi d'exemple següent...
|_+_|En aquest exemple, Introduïu la data és el nom del paràmetre. A més, DateTime defineix el tipus de dades.
com posar 1channel a kodi
Param. de PowerShell Interruptor Paràmetre
A les tres primeres subseccions d'aquesta secció, he parlat dels tipus de paràmetres de PowerShell que requereixen l'entrada d'un usuari.
Tanmateix, hi ha un tipus de paràmetre de PowerShell que no requereix l'entrada d'un usuari. A diferència dels altres tipus de paràmetres, a interruptor el paràmetre no requereix l'entrada de l'usuari.
La manera de definir a interruptor El paràmetre és similar a la manera de definir altres tipus de paràmetres. Tanmateix, en lloc de interruptor , int , o datetime , utilitza la paraula interruptor .
Per exemple, per definir un paràmetre de PowerShell Interruptor paràmetre, Exportar CSV , utilitza el codi següent...
|_+_|Finalment, per a aquesta secció, potser us estareu preguntant sobre l'aplicació de interruptor paràmetres. Penseu en un script o funció de PowerShell que pugui mostrar resultats a la consola de PowerShell.
També és possible que vulgueu donar a l'usuari l'opció d'exportar el resultat a un fitxer de text o a un fitxer CSV.
Una manera de codificar la funció és crear 3 paràmetres de commutació. Aleshores, un usuari pot seleccionar un dels paràmetres, depenent de com vulgui que la funció proporcioni el resultat.
Aquest tipus de paràmetre no requereix que l'usuari introdueixi cap entrada. Simplement seleccionant el paràmetre, la funció mostrarà la sortida en conseqüència.
També podeu definir altres paràmetres de PowerShell amb tipus de dades específics. Per obtenir informació sobre els tipus de dades de PowerShell, visiteu aquest enllaç: Com definir els tipus de dades de PowerShell .Atributs i arguments dels paràmetres de PowerShell
A la sintaxi de PowerShell Param d'aquesta guia, vaig donar a entendre que un paràmetre de PowerShell té atributs. A més, també vaig assenyalar que cada atribut de paràmetre també té arguments.
En aquesta secció, parlaré dels atributs dels paràmetres i dels seus arguments.
Per explicar els atributs dels paràmetres i els seus arguments, em referiré a la sintaxi de PowerShell param introduïda a la primera secció d'aquesta guia.
|_+_|Param. de PowerShell CmdletBinding Atribut
El CmdletBinding generalment s'especifica abans del bloc de param. Quan definiu el CmdletBinding atribut, PowerShell reconeixerà l'script com una funció avançada.
A la secció de sintaxi d'aquesta guia, he utilitzat aquest codi com a versió simplificada d'un bloc de param.
|_+_|En aquesta secció, em centraré en el CmdletBinding Atribut part del codi. Aquí és com definir el Atribut …
|_+_|En els següents 3 subapartats, parlaré d'alguns dels arguments comuns, que podeu definir a la CmdletBinding atribut.
Per evitar dubtes, cal definir-ho tot Arguments dins del bloc () del Atribut . A més, HEU de separar tots els atributs amb una coma (,), excepte l'últim Arguments dins de Atribut .
Param. de PowerShell DefaultParameterSetName Argumentació
Quan desenvolupeu una funció PowerShell, pot contenir diversos paràmetres que un usuari pot utilitzar a la mateixa ordre. A més, la mateixa funció de PowerShell pot contenir un altre conjunt de paràmetres que un usuari pot utilitzar en una altra ordre.
Tanmateix, l'usuari no pot barrejar els paràmetres del primer conjunt amb els del segon conjunt.
A més, un desenvolupador de funcions defineix tots els paràmetres que un usuari pot utilitzar en la mateixa comanda amb el ParameterSetName argument. El ParameterSetName L'argument es defineix dins de l'atribut del paràmetre (més sobre això a la secció següent).
La implicació de tenir diferents conjunts de paràmetres agrupats és que tindreu diferents ParameterSetName s.
Amb diferent ParameterSetName s desafiat al vostre bloc de param, podeu decidir definir un dels ParameterSetName s com a predeterminat. Aquí és on s'utilitza el DefaultParameterSetName Argumentació.
Windows no ha pogut enllaçar automàticament la pila de protocols IP a l'adaptador de xarxa Windows 10
El DefaultParameterSetName L'argument es defineix dins de CmdletBinding bloc d'atributs. Aquí teniu un exemple...
|_+_|Finalment, per conservar el nostre format de bloc de paràmetres de PowerShell, tornaré a introduir el bloc de paràmetres a continuació...
|_+_|Param. de PowerShell AdmetShouldProcess Argumentació
Aquest és un altre argument que podeu definir al CmdletBinding Atribut . Com el DefaultParameterSetName Argument, el AdmetShouldProcess L'argument és opcional.
El AdmetShouldProcess L'argument afegeix el Confirmeu i Què passa si paràmetres comuns a la funció.
Per afegir aquest argument, afegiu una coma (,) al final de l'argument DefaultParameterSetName argument. A continuació, afegiu la línia - AdmetShouldProcess =$vertader o $fals.
Amb aquest nou argument inclòs, el CmdletBinding Atribut ara es veurà així...
|_+_|Param. de PowerShell HelpURI Argumentació
Si esteu familiaritzat amb PowerShell Aconseguir ajuda Cmdlet, potser us heu trobat En línia paràmetre. Quan corres Aconseguir ajuda amb el En línia paràmetre, PowerShell obre la pàgina d'ajuda en línia del cmdlet.
Per exemple, per obrir la pàgina d'ajuda en línia del cmdlet Out-File, executeu l'ordre següent...
|_+_|La pàgina oberta per aquesta ordre es defineix en una funció per l' HelpURI Argumentació. Per tant, si voleu que els usuaris accedeixin a la pàgina d'ajuda en línia de la vostra funció, definiu el HelpURI Argumentació.
Aquí teniu un exemple...
|_+_|Ara inclouré aquest darrer argument al fitxer CmdletBinding Atribut . Aquí teniu el codi actualitzat...
|_+_|Param. de PowerShell Paràmetre Atribut
Al PowerShell Param CmdletBinding A la subsecció d'atributs, vaig comentar 3 arguments que podeu incloure al CmdletBinding Bloc d'atributs.
Com heu vist, el CmdletBinding El bloc d'atributs és l'únic atribut definit fora del bloc de param.
En aquesta subsecció, coneixeràs l'atribut del paràmetre. A més, també coneixeràs els arguments comuns que pots afegir a aquest atribut.
Com haureu deduït dels exemples ja utilitzats en aquesta guia, l'atribut de paràmetre defineix arguments que controlen el comportament d'un paràmetre de paràmetre de PowerShell.
Podeu definir l'atribut del paràmetre tancant la paraula Paràmetre, seguida de claudàtors () en un bloc []. Aquí teniu un exemple...
|_+_|Seguint, HEU de definir tots els arguments de l'atribut del paràmetre dins del bloc ().
A les següents subseccions de la secció Atribut de paràmetres de PowerShell, presentaré i explicaré els arguments comuns que podeu definir dins de l'atribut de paràmetres.
Param. de PowerShell ParameterSetName Argumentació
Quan vaig explicar DefaultParameterSetName anteriorment en aquesta guia, vaig presentar ParameterSetName Argumentació. Podeu utilitzar aquest argument per agrupar o agrupar paràmetres que un usuari pot executar a la mateixa ordre.
Per exemple, per definir a ParameterSetName va trucar ParameterSetName1 , introduïu el codi següent al bloc Atribut de paràmetre ().
|_+_|Quan introdueixo aquest codi actualitzat, el bloc de param. del meu codi de mostra ara es veurà així.
|_+_|Si torno a portar el CmdletBinding atribut, el meu codi de paràmetres de PowerShell de mostra ara tindrà aquest aspecte...
|_+_|Param. de PowerShell Obligatòria Argumentació
Podeu utilitzar el Obligatòria argument per definir si un paràmetre és obligatori o opcional. El Obligatòria L'argument accepta un valor $true o $false: $true significa requerir, $fals, no obligatori.
A més, el Obligatòria l'argument és opcional. Tanmateix, si aquest argument no està definit, el paràmetre es tractarà com a opcional.
Per definir el Obligatòria Argument, afegiu el codi següent al bloc d'atributs de paràmetre...
|_+_|Finalment, si inclou el Obligatòria Codi d'argument al meu codi de paràmetre de PowerShell, ara tindré...
|_+_|Param. de PowerShell Posició Argumentació
El Posició L'argument de l'atribut del paràmetre defineix la posició del paràmetre. El valor és un nombre enter, començant per 0 (zero).
El benefici de la Posició L'argument és permetre als usuaris executar la funció utilitzant la posició dels paràmetres. Concretament, quan definiu el Posició Argument, un usuari pot introduir valors per a cada paràmetre a la línia d'ordres sense especificar el paràmetre.
PowerShell assignarà cada valor a la línia d'ordres segons la posició del paràmetre.
Per exemple, el Get-ChildItem Cmdlet té un paràmetre anomenat Camí (amb posició 0). El Cmdlet també té un altre paràmetre, Filtre (amb la posició 1).
Per defecte, si executo el Get-ChildItem comanda, he d'incloure els noms dels paràmetres abans d'afegir-ne els valors. Vegeu la comanda a continuació...
|_+_|En aquesta comanda, vaig cridar els paràmetres i després vaig especificar els seus valors.
Tanmateix, com que conec les posicions d'aquests 2 paràmetres, puc afegir valors a les seves posicions, sense cridar expressament els paràmetres. Aleshores modificaré la meva comanda tal com es mostra a continuació...
|_+_|Evidentment, això m'estalvia temps! Tanmateix, si esteu mirant un codi de PowerShell llarg, això pot causar certa confusió.
L'ordre dóna el mateix resultat a PowerShell...
PowerShell assignarà automàticament els valors de les posicions als paràmetres en funció dels seus Posició Argumentació.
Seguint endavant, aquí és com definiu el Posició Argumentar...
|_+_| En aquest exemple, la posició del meu paràmetre és 0 (zero). Quan defineixi el meu següent paràmetre, estarà a la posició 1, i així successivament. No podeu tenir dos paràmetres a la mateixa posició. Més endavant a la guia, aprendràs a afegir un paràmetre a la mateixa posició però diferents ParameterSetNames.Ara afegiré aquest argument al meu codi d'exemple...
|_+_|Param. de PowerShell ValueFromPipeline Argumentació
Un altre paràmetre d'augment d'ús habitual és el ValueFromPipeline Argumentació. Com el seu nom indica, aquest argument determina si un paràmetre accepta valors de la canalització.
Ella és com defineixes aquest argument...
|_+_|Si afegeixo aquest nou argument al meu codi, semblarà així...
|_+_|Hi ha un altre argument anomenat ValueFromPipelineByPropertyName . Per llegir sobre aquest argument, visiteu about_Functions_Advanced_Parameters .
Param. de PowerShell Missatge d'ajuda Argumentació
Podeu utilitzar aquest argument per especificar el missatge per mostrar als usuaris com utilitzar un paràmetre. Per definir a Missatge d'ajuda Argument per a un paràmetre, utilitzeu un codi similar al següent...
servei avast (32 bits)|_+_|
I aquí teniu el meu codi actualitzat...
|_+_|Fins ara, en aquesta secció, he parlat de 2 atributs de paràmetres de PowerShell: CmdletBinding i Paràmetre . A més, també vaig parlar dels arguments comuns que podeu definir per a aquests atributs.
A les 3 subseccions restants d'aquesta secció, us ensenyaré 3 atributs de paràmetres de PowerShell més utilitzats. Tanmateix, aquests 3 atributs no requereixen que definiu arguments.
Param. de PowerShell Àlies Atribut
L'atribut àlies s'utilitza per especificar els àlies d'un paràmetre. Com haureu endevinat, es pot utilitzar l'àlies d'un paràmetre de PowerShell en comptes del paràmetre.
Abans de mostrar-vos com definir l'atribut d'àlies d'un paràmetre, deixeu-me que us mostri com trobar àlies de tots els cmdlets i funcions al vostre ordinador.
Per llistar tots els àlies per a cmdlets i funcions, executeu l'ordre següent
|_+_|Això enumerarà tots els àlies...
Passant a Àlies Atribut, per definir-ne un per a un paràmetre de paràmetre de PowerShell, utilitzeu un codi similar al següent...
|_+_| En aquest exemple, FP és l'àlies del paràmetre.Si afegeixo això al meu codi, la versió actualitzada tindrà aquest aspecte...
|_+_|Param. de PowerShell Admet comodins Atribut
Aquest atribut de paràmetre param determina si un paràmetre accepta comodins. Així és com defineixes aquest atribut...
|_+_|Param. de PowerShell ValidateNotNullOrEmpty Atribut de validació
Com la majoria dels atributs ja tractats en aquesta guia, el nom d'aquest atribut també ho revela. És un atribut de validació.
Quan definiu aquest atribut, el paràmetre NO acceptarà un valor nul ($null). A més, no acceptarà un valor () buit.
Si un usuari introdueix $null, o , la funció generarà un error. Per definir aquest atribut, introduïu el codi següent...
|_+_|Finalment, actualitzaré el meu codi amb els darrers 2 atributs...
|_+_|Nom del paràmetre de PowerShell
Després d'haver definit tots els atributs i arguments d'un paràmetre, cal afegir el nom del paràmetre. Un paràmetre de paràmetre de PowerShell es defineix com una variable, amb un signe de dòlar ($), seguit del nom del paràmetre.
També podeu introduir opcionalment un tipus de dades per al paràmetre. A la secció 2 d'aquesta guia, vaig parlar de diferents tipus de paràmetres de PowerShell.
Aquí és com es defineix un paràmetre que pot acceptar corda tipus de dades.
|_+_|Aquí teniu el meu exemple de codi actualitzat...
|_+_|Com definir un paràmetre de PowerShell en diversos conjunts de paràmetres
Si sou nou a la codificació de funcions de PowerShell, és probable que caigueu en la temptació de definir un paràmetre diverses vegades.
Un dels motius pels quals és possible que vulgueu tenir un paràmetre diverses vegades és quan s'utilitza un paràmetre en diversos ParameterSetNames (diversos conjunts de paràmetres).
Per conduir aquesta casa, suposem que esteu desenvolupant una funció de PowerShell que té un Camí paràmetre. Tanmateix, teniu 2 ParameterSetNames que requereixen el paràmetre Path.
És probable que la majoria de les persones noves en els scripts de PowerShell definiran els paràmetres que es mostren a continuació...
|_+_|Si definiu els paràmetres, tal com es mostra més amunt, rebreu un missatge d'error. Per provar aquesta teoria, copiaré el codi a PowerShell ISE.
Aleshores, com ho arregles? La solució és definir els 2 atributs de paràmetre i els seus arguments, inclosos els seus ParameterSetNames.
Aleshores, al final dels dos atributs de paràmetre, definiu un sol nom de paràmetre que sigui comú als dos atributs de paràmetre. A l'exemple anterior, eliminaré el primer nom del paràmetre i deixaré l'últim.
|_+_|Ara, si copio aquest codi a PowerShell ISE, anirà bé.
En aquest exemple, tingueu en compte que els arguments dels paràmetres dels dos atributs del paràmetre poden ser completament diferents. A més, podeu definir tants atributs de paràmetre com vulgueu.Exemples de paràmetres de PowerShell
En aquesta darrera secció de la guia, donaré un exemple de paràmetre de PowerShell de SysAdmin de la vida real.
Mentre escrivia aquesta guia, vaig començar a desenvolupar un script/funció de PowerShell per obtenir la mida de la carpeta i el recompte de fitxers. Aquí teniu la part de param de la funció...
|_+_|En els següents subapartats d'aquesta secció, explicaré els diferents elements del paràmetre. Finalment, l'última secció introdueix un bloc de funcions i afegeix el bloc de paràmetres a la funció.
Per facilitar-vos el seguiment de les línies del codi a què es fa referència a les subseccions següents, descarregueu PowerShellParamExample.zip . A continuació, descomprimiu el fitxer i obriu el fitxer .ps1 a PowerShell ISE .
ParameterSetName Exemple de paràmetres de PowerShell
El meu codi d'exemple de paràmetres de PowerShell té tres ParameterSetNames: Mostra resultats , ExportTxt i Exportar CSV . Vaig utilitzar aquests noms per facilitar la identificació del que fan.
A la introducció d'aquesta secció, he esmentat que la funció que estic creant amb aquest codi de paràmetre mostrarà la mida de la carpeta i el recompte de fitxers per a cada subcarpeta d'una carpeta especificada.
Per tant, els tres ParameterSetNames ofereixen a l'usuari l'opció de mostrar resultats a la consola de PowerShell. Alternativament, un usuari té l'opció d'exportar el resultat a un fitxer de text o un fitxer CSV.
A més, cadascun ParameterSetName definir tots els paràmetres que un usuari pot cridar en una única comanda. A partir d'aquesta idea, la funció que estic creant tindrà tres opcions d'ordres o sintaxis.
Ampliaré aquesta idea en els subapartats i exemples següents.
CmdletBinding Atribut I DefaultParameterSetName Exemples d'arguments
A les seccions anteriors d'aquesta guia, us heu trobat amb el CmdletBinding Atribut. A més, també us heu trobat amb un dels seus arguments: DefaultParameterSetName .
macros de teclat de Windows 7
El DefaultParameterSetName L'argument s'utilitza per definir el conjunt de paràmetres predeterminat que crida una funció. En aquest exemple, el nom del conjunt de paràmetres per defecte és Mostra resultats .
El DefaultParameterSetName es declara a la línia 1 del codi.
PowerShell intentarà utilitzar el conjunt de paràmetres declarat per DefaultParameterSetName si no pot determinar quin conjunt de paràmetres utilitzar. Tanmateix, si configureu paràmetres obligatoris, podeu evitar aquest problema.
En qualsevol cas, no hi ha cap mal declarar un nom de conjunt de paràmetres predeterminat.
FolderPath Exemple de paràmetre de cadena
Aquí és on comença la diversió! El FolderPath El paràmetre s'utilitza per introduir la ruta de la carpeta, la funció obtindrà la mida de les seves subcarpetes i comptarà el nombre de fitxers a cada subcarpeta.
Aquest és un paràmetre de cadena. Significa que accepta qualsevol cadena com a entrada.
Una característica emocionant de la FolderPath El paràmetre és que és comú als 3 noms de conjunt de paràmetres. A principis d'aquest article, vaig explicar el repte que poden enfrontar els nous desenvolupadors d'scripts de PowerShell amb aquesta situació.
Per declarar el FolderPath paràmetre en els tres noms de conjunt de paràmetres, vaig crear tres atributs de paràmetre.
El primer atribut de paràmetre es troba entre les línies 5 i 11. A més, aquest primer atribut de paràmetre té diversos arguments.
No obstant això, m'agradarà que presteu especial atenció al ParameterSetName argument - Mostra resultats .
En segon lloc, entre les línies 12 i 18, vaig declarar un altre atribut de paràmetre amb a ParameterSetName argument anomenat ExportTxt .
Finalment, entre les línies 19 i 25, vaig declarar un tercer atribut de paràmetre amb a ParameterSetName argument anomenat Exportar CSV .
A més, si observeu, a diferència de declarar 3 atributs de paràmetre, n'he declarat un únic Àlies , i ValidateNotNullOrEmpty atributs. Aquests atributs es poden trobar a les línies 26 i 27.
Finalment, just a sota de tots els atributs i els seus arguments, vaig incloure el nom del paràmetre: FolderPath . El nom del paràmetre és a la línia 28.
A l'última subsecció d'aquesta secció, veureu com la funció mostra aquest paràmetre en 3 sintaxis d'ordres.Mostra resultats , ExportTxt I Exportar CSV Exemple de paràmetre de canvi
A la línia 29 del codi de paràmetre, vaig declarar un altre conjunt d'atributs de paràmetre i els seus arguments.
En primer lloc, entre les línies 29 i 37, declaro els atributs i els arguments del paràmetre per al Mostra resultats paràmetre.
Aleshores, entre les línies 38 i 47, declaro un altre paràmetre anomenat ExportTxt .
Finalment, entre les línies 48 i 57, vaig declarar el Exportar CSV paràmetre.
Els 3 paràmetres que he descrit en aquesta secció són tots Interruptor paràmetres. Com ja sabeu, això vol dir que els paràmetres no requereixen cap entrada per part de l'usuari.
Quan un usuari selecciona qualsevol dels paràmetres, la funció canvia la forma en què mostra els resultats.
Com utilitzar PowerShell Param en una funció de PowerShell
En aquesta subsecció, vull introduir el bloc de funcions PowerShell al meu codi d'exemple.
La sintaxi d'un bloc de funcions de PowerShell és...
|_+_|Per a l'últim exemple d'aquesta guia, substituiré el bloc de paràmetres de PowerShell dins de la sintaxi de la funció amb el meu codi de paràmetres de l'última subsecció. A més, substituiré la funció per Get-FolderSizeFileCount , el nom de la funció.
La funció final ara serà així...
|_+_| Per a aquest exemple, els blocs Inici {}, Procés {} i Final {} estan buits.Prova els meus paràmetres de PowerShell a la funció PowerShell
En aquesta darrera secció, provaré els paràmetres de la funció que vaig crear a la darrera secció.
Si voleu provar-lo vosaltres mateixos, podeu descarregar el codi fent clic en aquest enllaç: Get-FolderSizeFileCount.zip. A continuació, descomprimiu el fitxer zip.
Un cop descomprimiu el fitxer, obriu PowerShell i executeu l'ordre següent:
|_+_| Canvieu a la ruta completa del fitxer descomprimit.Quan executeu l'ordre, rebreu un missatge d'advertència. A la sol·licitud del missatge, introduïu R i premeu la tecla Intro del vostre teclat.
Un cop importat el mòdul, a la mateixa consola de PowerShell, executeu l'ordre següent:
|_+_|Aquí teniu el resultat de l'ordre...
El que vull mostrar-vos és la secció SINTAXI de la pàgina d'ajuda de la meva funció. A la captura de pantalla anterior, podeu executar l'ordre Get-FolderSizeFileCount en 3 ordres diferents:
|_+_|El primer que cal tenir en compte és que les tres sintaxis tenen el FolderPath paràmetre de cadena. Si llegiu aquesta guia, sabreu per què.
A més, notareu que la primera sintaxi té Mostra resultats canvi de paràmetre també. Finalment, a la segona i tercera sintaxis, teniu el Exportar CSV , i ExportTxt canvi de paràmetre respectivament.
A més de la FolderPath , i Exportar CSV paràmetres i ExportTxt paràmetres en la segona i tercera sintaxis respectivament, també tenen el ReportPath paràmetre de cadena. No he esmentat aquest paràmetre perquè el codi de declaració és similar al FolderPath codi, amb algunes petites diferències. El ReportPath s'utilitza per especificar el camí en què la funció desarà els informes de fitxers de text i CSV.Això és tot: una guia completa sobre els paràmetres de PowerShell! Espero que us hagi estat útil?
el meu lg v10 no s'encén
Si us ha semblat útil, si us plau voteu Sí a la pregunta Va ser útil aquesta publicació a continuació.
Alternativament, podeu fer una pregunta, deixar un comentari o proporcionar més comentaris amb el formulari Deixa una resposta que es troba al final d'aquesta pàgina.
Finalment, per obtenir més zones S de tecnologia de PowerShell, visiteu la nostra pàgina de guia de instruccions de Windows PowerShell. També pot ser que la nostra pàgina de treball des d'inici sigui molt útil.
