Invoke-Item
Realiza la acción predeterminada en el elemento especificado.
Syntax
Invoke-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]Invoke-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]Description
El Invoke-Item cmdlet 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 al tipo de archivo del documento.
La acción predeterminada depende del tipo de elemento y viene determinado por 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 los 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:\Documents and Settings\Lister\My 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 los archivos ".xls".
Invoke-Item "C:\Documents and Settings\Lister\My Documents\*.xls"Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.
Escriba un nombre de usuario, como "User01" o "Domain01\User01", o escriba un objeto PSCredential , como uno generado por el Get-Credential cmdlet.
Si escribe un nombre de usuario, se le pedirá una contraseña.
Advertencia
Este parámetro no es compatible con los proveedores instalados con Windows PowerShell.
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Exclude
Especifica, como una matriz de cadenas, un elemento o elementos que este cmdlet excluye de la operación. El valor de este parámetro califica el parámetro Path. Escriba un elemento de ruta de acceso o un patrón, como "*.txt". Se permite el uso de caracteres comodín.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Filter
Especifica un filtro en el formato o idioma del proveedor. El valor de este parámetro califica el parámetro Path.
La sintaxis del filtro, incluido el uso de caracteres comodín, depende del proveedor. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos una vez recuperados.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Include
Especifica, como una matriz de cadenas, un elemento o elementos que este cmdlet incluye en la operación. El valor de este parámetro califica el parámetro Path. Escriba un elemento de ruta de acceso o un patrón, como "*.txt". Se permite el uso de caracteres comodín.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LiteralPath
Especifica una ruta de acceso al elemento. A diferencia del parámetro Path, el valor de LiteralPath se usa exactamente como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso contiene caracteres de escape, escríbalos entre comillas simples. Las comillas simples indican a PowerShell que no interprete caracteres como secuencias de escape.
| Type: | String[] |
| Aliases: | PSPath |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Path
Especifica la ruta de acceso al elemento seleccionado.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro solo es válido cuando hay una transacción en curso. Para obtener más información, consulte about_transactions.
| Type: | SwitchParameter |
| Aliases: | usetx |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Puede canalizar una cadena que contiene una ruta de acceso a este cmdlet.
Salidas
None
El comando no genera ningún resultado. Sin embargo, se podrían generar resultados en función del elemento que se invoca.
Notas
Este cmdlet está diseñado para trabajar con los datos expuestos por cualquier proveedor. Para enumerar los proveedores disponibles en la sesión, escriba Get-PSProvider. Para más información, vea about_Providers.