Condividi tramite


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
$w = Get-SPWeb https://sitename
$w.set_SiteLogoUrl("https://PathToImage/test.jpg")
$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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition