Invoke-Item (Microsoft.PowerShell.Management)

Invoke-Item

Módulo:

Microsoft.PowerShell.Management

Realiza la acción predeterminada en el elemento especificado.

Sintaxis

Invoke-Item
      [-Path] <String[]>
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Invoke-Item
      -LiteralPath <String[]>
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descripción

El cmdlet Invoke-Item realiza la acción predeterminada en el elemento especificado. Por ejemplo, ejecuta un archivo ejecutable o abre un archivo de documento en la aplicación asociada con el tipo de archivo de documento. La acción predeterminada depende del tipo de elemento y la determina el proveedor de PowerShell que proporciona acceso a los datos.

Ejemplos

Ejemplo 1: abrir un archivo

Este comando abre el archivo aliasApr04.doc en Microsoft Office Word. En este caso, abrir en Word es la acción predeterminada para archivos .doc.

Invoke-Item "C:\Test\aliasApr04.doc"

Ejemplo 2: abrir todos los archivos de un tipo específico

Este comando abre todas las hojas de cálculo de Microsoft Office Excel en la carpeta C:\Users\User1\Documents. Cada hoja de cálculo se abre en una nueva instancia de Excel. En este caso, abrir en Excel es la acción predeterminada para archivos .xls.

Invoke-Item "C:\Users\User1\Documents\*.xls"

Parámetros

-Confirm

Le solicita confirmación antes de ejecutar el cmdlet.

Tipo :

SwitchParameter

Alias:

cf

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

-Credential

Tipo :

PSCredencial

Posición:

Nombrado

Valor predeterminado:

Usuario actual

Requerido:

False

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-Exclude

Especifica, como una matriz de cadenas, uno o más elementos que este cmdlet excluye en la operación. El valor de este parámetro califica el parámetro Path. Introduzca un elemento o patrón de ruta, como *.txt. Se permiten caracteres comodín. El parámetro Excluir es efectivo solo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del C:\Windows.

Tipo :

String[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

True

-Filter

Especifica un filtro para calificar el parámetro Path. El proveedor FileSystem es el único proveedor de PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis del idioma de filtro FileSystem en about_Wildcards. Los filtros son más eficientes que otros parámetros, porque el proveedor los aplica cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos después de recuperarlos.

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

True

-Include

Especifica, como una matriz de cadenas, uno o varios elementos que este cmdlet incluye en la operación. El valor de este parámetro califica el parámetro Path. Introduzca un elemento de ruta o patrón, como "*.txt". Se permiten caracteres comodín. El parámetro Incluir es efectivo solo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del C:\Windows.

Tipo :

String[]

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

True

-LiteralPath

Especifica una ruta a una o más ubicaciones. El valor de LiteralPath se utiliza exactamente tal como se escribe. Ningún carácter se interpreta como comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples le indican a PowerShell que no interprete ningún carácter como secuencia de escape.

Para obtener más información, consulte about_Quoting_Rules.

Tipo :

String[]

Alias:

PSPath, LP

Posición:

Nombrado

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-Path

Especifica la ruta al elemento seleccionado. Se permiten caracteres comodín.

Tipo :

String[]

Posición:

0

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

True

-WhatIf

Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo :

SwitchParameter

Alias:

wi

Posición:

Nombrado

Valor predeterminado:

False

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Cadena

Puede canalizar una cadena que contenga una ruta a este cmdlet.

Salidas

Ninguno

Este cmdlet no devuelve ningún resultado propio, pero los elementos que invoca pueden devolver su propio resultado.

Notas

PowerShell incluye los siguientes alias para Invoke-Item:

ii

Este cmdlet está diseñado para funcionar con los datos expuestos por cualquier proveedor. Para enumerar los proveedores disponibles en su sesión, escriba Get-PSProvider. Para obtener más información, consulte about_Providers.