Get-SPSiteAdministration

Restituisce un oggetto di amministrazione del sito che consente agli amministratori di farm di visualizzare determinate informazioni sulle raccolte siti a cui potrebbero non avere accesso.

Sintassi

Get-SPSiteAdministration
   [-Identity] <SPSiteAdministrationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-WhatIf]
   [<CommonParameters>]
Get-SPSiteAdministration
   -ContentDatabase <SPContentDatabasePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]
Get-SPSiteAdministration
   -SiteSubscription <SPSiteSubscriptionPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]
Get-SPSiteAdministration
   [-AssignmentCollection <SPAssignmentCollection>]
   [-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-SPSiteAdministration restituisce un oggetto di amministrazione del sito che consente agli amministratori di farm di visualizzare determinate informazioni sulle raccolte siti a cui potrebbero non avere accesso.

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-SPSiteAdministration | Select -Property Url, OwnerLoginName, @{Name="Storage";Expression={$_.Quota.StorageMaximumLevel}}

Questo esempio consente di recuperare un sottoinsieme di dati da tutti i siti nel database del contenuto con URL b399a366-d899-4cff-8a9b-8c0594ee755f (non è richiesto l'accesso per l'amministratore della farm). Questo comando utilizza la proprietà calcolata Storage per visualizzare lo spazio di archiviazione massimo per il database del contenuto.

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

Start-SPAssignment -Global
$s = Get-SPSiteAdministration -Identity https://MyApp/Sites/Site1
$s.Url
Stop-SPAssignment -Global

Questo esempio consente di recuperare le raccolte siti specificate dal parametro Identity e di inserire i risultati nella variabile s. In questo esempio viene utilizzato il metodo di Garbage Collection Global. Si tratta di un metodo più semplice da utilizzare ma che comporta una crescita rapida del volume di risultati. Non eseguire un comando Get-SPSite che restituisce troppi risultati quando è attiva l'assegnazione globale.

------------------EXAMPLE 3-------------------

C:\PS>$GC = Start-SPAssignment
$Sites = $GC | Get-SPSiteAdministration -Filter {$_.Owner -eq "DOMAIN\JDoe"} -Limit 50
Stop-SPAssignment $GC

Questo esempio consente di recuperare i primi 50 siti di proprietà dell'utente DOMAIN\JDoe tramite una query sul lato server e di assegnare i siti restituiti a una variabile locale. In questo comando vengono utilizzati i metodi di assegnazione avanzati.

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

Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.DiskUsed }{$sum}

Questo comando consente di restituire la somma dello spazio su disco utilizzato per tutti i siti nell'applicazione Web specificata.

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

Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit ALL | Select URL

Questo esempio consente di recuperare gli URL per tutte le raccolte siti in un'applicazione Web.

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

Get-SPSiteAdministration -identity "https://localserver/(my|personal)/sites" -Regex

Questo esempio consente di restituire tutti i siti corrispondenti all'espressione regolare specificata. Le virgolette che racchiudono il valore specificato per il parametro Identity sono obbligatorie quando si utilizza il contrassegno Regex.

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

Get-SPSite "https://sitename/sites/teams/*" -Limit 100

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

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

-ContentDatabase

Specifica l'URL (completo o parziale) o il GUID della raccolta siti da recuperare.

Il tipo deve essere un URL valido nel formato https://server_name oppure un GUID nel formato 1234-456-987fg.

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 di filtro valido e un valore nel formato { $_ PropertyName <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 l'URL (completo o parziale) o il GUID della raccolta siti da recuperare.

Il tipo deve essere un URL valido nel formato https://server_name oppure un GUID nel formato 1234-456-987fg.

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

-Regex

Se si specifica questo parametro, l'URL indicato per il parametro Identity verrà 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 il gruppo di siti da cui recuperare le raccolte siti.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un oggetto o URL SPSite di una raccolta siti membro della sottoscrizione di sito oppure un'istanza di un oggetto SiteSubscription valido.

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