Get-SPAppInstance
Devuelve los metadatos de la instancia de una aplicación.
Sintaxis
IdentityParameterSet
Get-SPAppInstance
-Identity <SPAppInstance>
[-AssignmentCollection <SPAssignmentCollection>]
[<CommonParameters>]
SiteAndIdParameterSet
Get-SPAppInstance
-Site <SPSitePipeBind>
-AppInstanceId <Guid>
[-AssignmentCollection <SPAssignmentCollection>]
[<CommonParameters>]
WebParameterSet
Get-SPAppInstance
-Web <SPWebPipeBind>
[-App <SPApp>]
[-AssignmentCollection <SPAssignmentCollection>]
[<CommonParameters>]
Description
Este cmdlet contiene más de un conjunto de parámetros. Es posible que solo pueda usar parámetros procedentes de un conjunto de parámetros y no pueda combinar los parámetros de distintos conjuntos de parámetros. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.
Use el cmdlet Get-AppInstance para obtener una colección de instancias de las aplicaciones instaladas en un objeto SPWeb.
Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.
Ejemplos
EJEMPLO 1
Get-SPAppInstance -Web https://localhost
En este ejemplo se devuelve una colección si hay más de una aplicación instalada en https://localhost. Si solo hay una aplicación instalada, devuelve un único objeto.
EJEMPLO 2
Get-SPAppInstance -AppInstanceId $instance.Id
Este ejemplo devuelve el identificador de la instancia de una aplicación.
Parámetros
-App
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica la aplicación.
Este parámetro devuelve metadatos para todas las instancias de una aplicación.
Propiedades del parámetro
| Tipo: | SPApp |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
WebParameterSet
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AppInstanceId
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el identificador de instancia de la aplicación que se va a mostrar.
Propiedades del parámetro
| Tipo: | Guid |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
SiteAndIdParameterSet
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AssignmentCollection
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.
Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.
Propiedades del parámetro
| Tipo: | SPAssignmentCollection |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica la instancia de la aplicación cuyos metadatos desea buscar.
Propiedades del parámetro
| Tipo: | SPAppInstance |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
IdentityParameterSet
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Site
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Establece el ámbito de consulta de un sitio.
No incluye subsitios.
Propiedades del parámetro
| Tipo: | SPSitePipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
SiteAndIdParameterSet
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Web
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el objeto SPWeb.
Propiedades del parámetro
| Tipo: | SPWebPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
WebParameterSet
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.