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, SecondaryContact 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 TitleIn 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, SecondaryContactQuesto 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 -GlobalQuesto 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 $GCQuesto 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" -RegexQuesto 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 100Questo 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 14In 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 Subscription Edition |
-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 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 |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 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 |