Get-SPAppInstance
Restituisce i metadati per un'istanza di un'app.
Sintassi
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>]
Descrizione
Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.
Utilizzare il cmdlet Get-AppInstance per ottenere un insieme di istanze di applicazione installate in un oggetto SPWeb.
Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.
Esempio
ESEMPIO 1
Get-SPAppInstance -Web https://localhost
In questo esempio viene restituita una raccolta se sono installate più app in https://localhost. Se è installata una sola applicazione, verrà restituito un unico oggetto.
ESEMPIO 2
Get-SPAppInstance -AppInstanceId $instance.Id
In questo esempio viene restituito l'ID di un'istanza di un'applicazione.
Parametri
-App
Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifica l'applicazione.
Questo parametro restituisce i metadati per tutte le istanze di un'applicazione.
Proprietà dei parametri
| Tipo: | SPApp |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
WebParameterSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AppInstanceId
Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifica l'ID istanza di app da visualizzare.
Proprietà dei parametri
| Tipo: | Guid |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
SiteAndIdParameterSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AssignmentCollection
Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.
Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.
Proprietà dei parametri
| Tipo: | SPAssignmentCollection |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifica l'istanza dell'applicazione per cui trovare i metadati.
Proprietà dei parametri
| Tipo: | SPAppInstance |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
IdentityParameterSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Site
Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Imposta l'ambito di query su un sito.
I siti secondari non sono inclusi.
Proprietà dei parametri
| Tipo: | SPSitePipeBind |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
SiteAndIdParameterSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Web
Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Specifica l'oggetto SPWeb.
Proprietà dei parametri
| Tipo: | SPWebPipeBind |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
WebParameterSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.