Condividi tramite


Get-SPSite

Restituisce tutte le raccolte siti corrispondenti ai criteri specificati.

Sintassi

Get-SPSite
   [-Identity] <SPSitePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-WhatIf]
   [<CommonParameters>]
Get-SPSite
   -ContentDatabase <SPContentDatabasePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [-NeedsB2BUpgrade]
   [<CommonParameters>]
Get-SPSite
   -SiteSubscription <SPSiteSubscriptionPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]
Get-SPSite
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WebApplication <SPWebApplicationPipeBind>]
   [-WhatIf]
   [<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.

Il cmdlet Get-SPSite restituisce un singolo sito corrispondente al parametro Identity oppure tutti i siti corrispondenti al parametro Filter per l'ambito specificato. Gli ambiti sono indicati dai parametri WebApplication, ContentDatabase e SiteSubscription. Se non si specifica alcuno di questi ambiti, l'ambito utilizzato sarà la farm. Se si specifica l'ambito senza il parametro Filter, verranno restituiti tutti i siti inclusi in tale ambito.

Il parametro Identity supporta l'impostazione di un URL parziale che termina con un carattere jolly (*). In tal caso verranno restituite tutte le raccolte siti corrispondenti all'URL parziale indicato per l'ambito specificato. Se inoltre si specifica il parametro Regex, il parametro Identity verrà interpretato come un'espressione regolare e verrà restituita qualsiasi raccolta siti con un URL specificato nell'ambito indicato corrispondente all'espressione.

Il parametro Filter è un filtro lato server per determinate proprietà della raccolta siti archiviate nel database del contenuto; senza il parametro Filter, il filtro su queste proprietà è un processo lento. Queste proprietà della raccolta siti sono Owner, SecondaryOwner e LockState. Il parametro Filter è un blocco di script che usa la stessa sintassi di un'istruzione Where-Object, ma viene eseguito nel server per ottenere risultati più rapidi.

I valori validi per LockState sono Unlock, NoAdditions, ReadOnly e NoAccess.

È importante sottolineare che tutte le raccolte siti restituite dal cmdlet Get-SPSite vengono eliminate automaticamente in modo definitivo al termine della pipeline. Per archiviare i risultati di Get-SPSite in una variabile locale, 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-SPSite 'https://<site name>' | Get-SPWeb -Limit All | Select Title

In questo esempio viene recuperata la raccolta di titoli web secondari nella raccolta siti in https://< nome> del sito.

------------------ESEMPIO 2---------------------

Get-SPSite -ContentDatabase "b399a366-d899-4cff-8a9b-8c0594ee755f" | Format-Table -Property Url, Owner, SecondaryOwner

Questo esempio consente di recuperare un sottoinsieme di dati da tutti i siti inclusi nel database del contenuto b399a366-d899-4cff-8a9b-8c0594ee755f.

------------------ESEMPIO 3---------------------

Start-SPAssignment -Global

$s = Get-SPSite -Identity https://<MyApp>/Sites/Site1

$s.Url

Stop-SPAssignment -Global

Questo esempio consente di recuperare i siti specificati dal parametro Identity e di inserire i risultati nella variabile s.

Nell'esempio precedente viene utilizzato il metodo Global dell'insieme di assegnazioni. Il metodo Global è facile da utilizzare, ma il contenuto di tale oggetto si espande rapidamente. Prestare attenzione a non eseguire un comando Get-SPSite che restituisce troppi risultati quando è attivata l'assegnazione globale.

------------------ESEMPIO 4---------------------

$GC = Start-SPAssignment
$Sites = $GC | Get-SPSite -Filter {$_.Owner -eq "DOMAIN\JDow"} -Limit 50
Stop-SPAssignment $GC

Questo esempio consente di recuperare i primi 50 siti di proprietà dell'utente DOMAIN\JDow tramite una query sul lato server e di assegnarli a una variabile locale.

In questo esempio vengono utilizzati i metodi di assegnazione avanzati.

------------------ESEMPIO 5---------------------

Get-SPWebApplication https://<site name> | Get-SPSite -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.Usage.Storage }{$sum}

In questo esempio viene mostrato un comando che consente di recuperare la somma dello spazio su disco utilizzato per tutti i siti nell'applicazione Web specificata.

------------------ESEMPIO 6---------------------

Get-SPSite -Identity "https://localserver/(my|personal)/sites" -Regex

Questo esempio consente di restituire tutti i siti corrispondenti all'espressione regolare specificata.

È necessario inserire le virgolette nel parametro Identity quando si utilizza il parametro Regex.

------------------ESEMPIO 7---------------------

Get-SPSite https://<site name>/sites/teams/* -Limit 100

Questo esempio ottiene fino a 100 siti nell'URL https://sitename/sites/teams.

------------------ESEMPIO 8---------------------

Get-SPSite | select url, @{Expression={$_.Usage.Storage}}

Questo esempio consente di recuperare la quantità di spazio di archiviazione utilizzata da una raccolta siti utilizzando il campo di archiviazione (Storage) della proprietà .UsageInfo.

------------------EXAMPLE 9---------------------

Get-SPSite -Limit all -CompatibilityLevel 14

In questo esempio vengono restituite tutte le raccolte siti in modalità SharePoint Server.

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

-CompatibilityLevel

Specifica la versione dei modelli da utilizzare durante la creazione di un nuovo oggetto SPSite. Questo valore imposta il valore CompatibilityLevel iniziale per la raccolta siti. I valori per questo parametro possono essere SharePoint Server o SharePoint Server. Quando questo parametro non viene specificato, per impostazione predefinita il parametro CompatibilityLevel verrà configurato sulla versione più elevata possibile per l'applicazione Web a seconda dell'impostazione SiteCreationMode.

Type:Int32
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

-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

-ContentDatabase

Specifica il GUID del database del contenuto dal quale elencare le raccolte siti.

Il tipo deve essere un nome di database valido nel formato DBContenutoSP1 oppure un GUID valido, ad esempio 12345678-90ab-cdef-1234-567890bcdefgh.

Type:SPContentDatabasePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Filter

Specifica il blocco di script del filtro sul lato server da applicare.

Il tipo deve essere un nome e un valore di filtro validi nel formato {$_PropertyName <operatore> "filterValue"}.

Gli operatori validi sono EQ, NE, LIKE e NOTLIKE.

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 l'URL o il GUID della raccolta siti da recuperare.

Il tipo deve essere un URL valido nel formato https://server_name o https://server_name/sites/sitename oppure un GUID valido, ad esempio 12345678-90ab-cdef-1234-567890bcdefgh.

Type:SPSitePipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Limit

Limita il numero massimo di raccolte siti da restituire. Il valore predefinito è 200.

Il tipo deve essere un numero non negativo valido. Utilizzare ALL per restituire tutte le raccolte siti per l'ambito specificato.

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

-NeedsB2BUpgrade

Specifica se il sito deve essere aggiornato.

I valori validi sono True e False.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Regex

Se questo parametro viene utilizzato, l'URL indicato per il parametro Identity viene 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

-SiteSubscription

Specifica la sottoscrizione di sito da cui recuperare le raccolte siti.

Il tipo deve essere un URL valido nel formato https://server_name oppure un GUID valido, ad esempio 12345678-90ab-cdef-1234-567890bcdefgh.

Type:SPSiteSubscriptionPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WebApplication

Specifica l'URL, il GUID o il nome dell'applicazione Web da cui elencare i siti.

Il tipo deve essere un URL valido nel formato https://server_name, un GUID valido (ad esempio 12345678-90ab-cdef-1234-567890bcdefgh) oppure il nome dell'applicazione Web (ad esempio ApplicazioneWeb1212).

Type:SPWebApplicationPipeBind
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