Get-SPWeb
Restituisce tutti i siti secondari corrispondenti ai criteri specificati.
Sintassi
Get-SPWeb
[[-Identity] <SPWebPipeBind>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Filter <ScriptBlock>]
[-Limit <String>]
[-Regex]
[-Site <SPSitePipeBind>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Il cmdlet Get-SPWeb restituisce tutti i siti secondari corrispondenti all'ambito specificato dal parametro Identity. Verranno restituiti tutti i siti secondari corrispondenti ai criteri.
Il valore del parametro Identity può essere l'URL completo o un percorso relativo. Se si specifica un percorso relativo è necessario specificare anche il parametro Site per identificare la raccolta siti da cui restituire il sito secondario.
Il parametro Identity supporta anche l'impostazione di un URL parziale che termina con un carattere jolly (*). Verranno restituiti tutti i siti secondari corrispondenti all'URL parziale indicato per l'ambito specificato. Se si specifica il parametro Regex, inoltre, il parametro Identity viene elaborato come espressione regolare e verrà restituito qualsiasi sito secondario con un URL specificato nell'ambito indicato corrispondente all'espressione.
Il parametro Filter è un filtro lato server per determinate proprietà del sito secondario archiviate nel database del contenuto. senza il parametro Filter, il filtro su queste proprietà è un processo lento. Queste proprietà del sito secondario sono Template e Title. Il parametro Filter è un blocco di script che usa la stessa sintassi di un'istruzione Where-Object, ma viene eseguito sul lato server per ottenere risultati più rapidi.
È importante sottolineare che tutte le raccolte siti restituite dal cmdlet Get-SPWeb vengono eliminate automaticamente al termine della pipeline. Per archiviare i risultati di Get-SPWeb in una variabile locale, è necessario utilizzare i cmdlet Start-SPAssignment e Stop-SPAssignment per evitare perdite di memoria.
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-SPWeb -site https://sitename/sites/site1
Questo esempio consente di restituire tutti i siti secondari nella raccolta specificata.
--------------------ESEMPIO 2----------------------
Get-SPWeb -Site https://sitename/sites/site1 -filter {$_.Template -eq "STS#0"}
Questo esempio consente di visualizzare tutti i siti secondari che utilizzano il modello "STS#0".
--------------------ESEMPIO 3----------------------
Start-SPAssignment -Global
C:\PS>$w = Get-SPWeb https://sitename
C:\PS>$w.set_SiteLogoUrl("https://PathToImage/test.jpg")
C:\PS>$w.Update()
Stop-SPAssignment -Global
Questo esempio dimostra come salvare un sito secondario come variabile e come chiamare i metodi del modello a oggetti sull'oggetto SPAssignment.
Parametri
-AssignmentCollection
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.
Type: | SPAssignmentCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Confirm
Richiede la conferma prima di eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Filter
Specifica il filtro sul lato server da utilizzare per l'ambito specificato.
Il tipo deve essere un filtro valido nel formato {filterName <operator> "filterValue"}.
Type: | ScriptBlock |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Identity
Specifica il nome oppure l'URL completo o parziale del sito secondario. Se si utilizza un percorso relativo è necessario specificare il parametro Site.
URL valido nel formato https://server_name oppure un percorso relativo nel formato /SitiSecondari/SitoSecondario.
Type: | SPWebPipeBind |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Limit
Limita il numero massimo di siti secondari da restituire. Il valore predefinito è 200. Per restituire tutti i siti, specificare ALL.
Il tipo deve essere un numero valido maggiore di 0 oppure ALL.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Regex
Specifica che l'URL indicato dal parametro Identity deve essere interpretato come un'espressione regolare.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Site
Specifica l'URL o il GUID della raccolta siti da cui elencare i siti secondari.
Il tipo deve essere un URL valido nel formato https://server_name, un GUID nel formato 1234-5678-9807 oppure un oggetto SPSite.
Type: | SPSitePipeBind |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WhatIf
Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |