Condividi tramite

Get-SPWeb

Modulo:
SharePointServer module

Restituisce tutti i siti secondari corrispondenti ai criteri specificati.

Sintassi

Default (impostazione predefinita). 

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

Applicabile: SharePoint Server 2010, 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

-Confirm

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Filter

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il filtro sul lato server da utilizzare per l'ambito specificato.

Il tipo deve essere un filtro valido nel formato {filterName <operator> "filterValue"}.

Proprietà dei parametri

Tipo:ScriptBlock
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:SPWebPipeBind
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Limit

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Regex

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica che l'URL indicato dal parametro Identity deve essere interpretato come un'espressione regolare.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Site

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Proprietà dei parametri

Tipo:SPSitePipeBind
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

-WhatIf

Applicabile: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
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.