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