Detección de los parámetros para usar cmdlets de PowerShell

Completado

Los parámetros modifican las acciones que realiza un cmdlet. No puede especificar parámetros, un parámetro o varios parámetros para un cmdlet.

Formato de los parámetros

Los nombres de parámetro comienzan con un guion (-). Un espacio separa el valor que se quiere pasar del nombre del parámetro. Si el valor que pasa contiene espacios, debe encapsular el texto entre comillas. Algunos parámetros aceptan varios valores, que están separados por comas y sin espacios.

Parámetros opcionales frente a obligatorios

Los parámetros pueden ser opcionales u obligatorios. Si se requiere un parámetro y se ejecuta el cmdlet sin proporcionar un valor para ese parámetro, Windows PowerShell le pide que proporcione un valor para él. Por ejemplo, si ejecuta el comando Get-Item, recibirá el siguiente mensaje de Windows PowerShell, que incluye una solicitud para proporcionar un valor para el parámetro -Path:

PS C:\> Get-Item cmdlet Get-Item at command pipeline position 1 Supply values for the following parameters: Path[0]:

Si escribe el texto C:\ en el símbolo del sistema y, a continuación, presiona la tecla Entrar dos veces, el comando se ejecuta correctamente. Debe presionar la tecla Intro dos veces porque este parámetro puede aceptar varios valores. Windows PowerShell seguirá solicitando un nuevo valor hasta que presione la tecla Intro sin proporcionarlo realmente.

En algunos casos, escribir el nombre del parámetro es opcional y solo puede escribir el valor del parámetro. Si ejecuta el comando Get-ChildItem C:\, es lo mismo que ejecutar el comando Get-ChildItem -Path C:\ porque el parámetro -Path se define como el primer parámetro de la definición del cmdlet. Esto se conoce como parámetro posicional. Lo observará a lo largo de este curso. Omitir el nombre del parámetro solo funciona cuando se ha definido una posición de parámetro. No todos los comandos tienen parámetros posicionales.

Conmutadores

Los conmutadores son un caso especial. Básicamente, son parámetros que aceptan un valor booleano (true o false). Difieren de los parámetros booleanos reales en que el valor solo se establece en true si el conmutador se incluye al ejecutar el comando. Un ejemplo es el parámetro -Recurse o el conmutador del cmdlet Get-ChildItem. El comando Get-ChildItem c:\ -Recurse no solo devolverá los elementos del directorio C:\, sino también los de todos sus subdirectorios. Sin el conmutador -Recurse, solo los elementos del directorio C:\ se devuelven.