Get-SPOSite

  • Riferimento
Modulo:
Microsoft.Online.SharePoint.PowerShell
Si applica a:
SharePoint Online

Restituisce una o più raccolte siti.

Sintassi

Get-SPOSite
   [[-Identity] <SpoSitePipeBind>]
   [-Detailed]
   [-Limit <String>]
   [<CommonParameters>]
Get-SPOSite
   [-Detailed]
   [-Filter <String>]
   [-IncludePersonalSite <Boolean>]
   [-Limit <String>]
   [-Template <String>]
   [-GroupIdDefined]
   [<CommonParameters>]
Get-SPOSite
   [-Identity] <SpoSitePipeBind>
   [-DisableSharingForNonOwnersStatus]
   [<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 di cmdlet.

Il cmdlet Get-SPOSite recupera e restituisce le proprietà di tutte le raccolte siti che soddisfano i criteri specificati.

Con la versione 5361 di SharePoint Online Management Shell si verifica quanto segue:

Vengono ora visualizzate ulteriori raccolte siti. Ad esempio, tutti i siti dei gruppi e dei video, nonché quelli dei team, vengono ora visualizzati.

Il parametro Detailed è stato deprecato. Continuerà a funzionare con le versioni precedenti

Nota

Le raccolte siti contenute nel Cestino non verranno recuperate utilizzando il cmdlet Get-SPOSite.

Per eseguire il cmdlet, è necessario essere amministratori di SharePoint Online o amministratori globali ed essere amministratori della raccolta di siti.

Per le autorizzazioni e le informazioni più aggiornate su Windows PowerShell per SharePoint Online, vedere la documentazione online alla pagina Introduzione a SharePoint Online Management Shell.

Nota

Se la gestione dello spazio di archiviazione nella raccolta siti è abilitata per il tenant, non sarà possibile impostare una quota e viene visualizzato un errore generico. Per risolvere questo problema, impostare temporaneamente la gestione dell'archiviazione della raccolta siti su "manuale", impostare le quote e quindi reimpostare l'impostazione di gestione archiviazione raccolta siti sull'impostazione originale.

Nota

Se vengono specificati i parametri Limit o Filter, le proprietà della raccolta siti seguenti non verranno popolate e potrebbero contenere un valore predefinito: AllowDownloadingNonWebViewableFiles, AllowEditing, AllowSelfServiceUpgrade, AnonymousLinkExpirationInDays, ConditionalAccessPolicy, DefaultLinkPermission, DefaultLinkToExistingAccess, DefaultSharingLinkType, DenyAddAndCustomizePages, DisableCompanyWideSharingLinks, ExternalUserExpirationInDays, InformationSegment, LimitedAccessFileType, OverrideTenantAnonymousLinkExpirationPolicy, OverrideTenantExternalUserExpirationPolicy, PWAEnabled, SandboxedCodeActivationCapability, SensitivityLabel, SharingAllowedDomainList, SharingBlockedDomainList, SharingCapability, SharingDomainRestrictionMode.

Esempio

-----------------------ESEMPIO 1-----------------------------

Get-SPOSite

Nell'esempio 1 vengono restituite tutte le raccolte siti.

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

Get-SPOSite -Identity https://contoso.sharepoint.com

Nell'esempio 2 viene elencata la raccolta siti con le proprietà dettagliate.

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

Get-SPOSite -Identity https://contoso.sharepoint.com -DisableSharingForNonOwnersStatus

Nell'esempio 3 viene aggiornato lo stato se gli utenti non proprietari di una raccolta siti possono condividere la raccolta siti (non imposta questo valore).

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

Get-SPOSite -Template GROUP#0 -IncludePersonalSite:$false

In questo esempio le raccolte siti del gruppo vengono enumerate in un tenant.

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

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/groupname -detailed |fl

In questo esempio si ottengono dettagli per il sito del gruppo.

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

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/research | Select InformationSegment

In questo esempio vengono restituiti gli InformationSegments associati al sito. È applicabile per i tenant che hanno abilitato la funzionalità Barriere informative di Microsoft 365. Leggere Informazioni sulle barriere informative per comprendere le barriere informative in SharePoint Online.

Nota: questa proprietà è disponibile solo in SharePoint Online Management Shell versione 16.0.19927.12000 o successiva.

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

Get-SPOSite -Filter { Url -like "contoso.sharepoint.com/sites/18" }

In questo esempio viene usato il filtro sul lato server per restituire i siti corrispondenti a 18.

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

Get-SPOSite -Limit ALL | ?{$_.IsTeamsConnected -eq $true}

In questo esempio viene usato il filtro sul lato client per restituire un elenco di siti connessi a Microsoft Teams.

-----------------------ESEMPIO 9-----------------------------

Get-SPOSite -Limit ALL | ?{$_.IsTeamsChannelConnected -eq $true}

In questo esempio viene usato il filtro sul lato client per restituire un elenco di siti connessi a un canale privato o condiviso di Microsoft Teams.

-----------------------ESEMPIO 10-----------------------------

Get-SPOSite -Limit ALL -GroupIdDefined $true

In questo esempio viene usato il filtro sul lato server per restituire tutti i siti a cui è associato un gruppo di Microsoft 365.

-----------------------EXAMPLE 11-----------------------------

$userUPN="joe.healy@contoso.com"
Get-SPOSite -Filter "Owner -like '$($userUPN)'"

In questo esempio vengono recuperati tutti i siti che filtrano in base al proprietario specificato usando una variabile.

Parametri

-Detailed

Utilizzare questo parametro per ottenere informazioni aggiuntive sulle proprietà di una raccolta siti. Quando si utilizza il parametro Detailed, i tempi di risposta sono più lenti.

Vengono restituite le proprietà seguenti:

  • ResourceUsageCurrent

  • ResourceUsageAverage

  • StorageUsageCurrent

  • LockIssue

  • WebsCount

  • CompatibilityLevel

  • AllowSelfServiceUpgrade

  • SiteDefinedSharingCapability

Restituisce il valore archiviato dei criterio del sito.

  • SharingCapability

Restituisce il livello di accesso effettivo, ovvero la combinazione tra criteri del sito e criteri del tenant.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-DisableSharingForNonOwnersStatus

Questo parametro impedisce la condivisione da parte dei non proprietari.

Nota

Questo parametro è disponibile solo in SharePoint Online Management Shell, versione 16.0.4613.1211 o successiva. DisableSharingForNonOwnersStatus non è un'impostazione persistente, ma un'analisi dello stato della raccolta siti. Lo scopo è ottenere questa impostazione e non è garantito che le altre impostazioni restituite siano corrette. Per ottenere altre impostazioni e valori, usare il Get-SPOSite senza questo parametro per assicurarsi che tutti gli elementi vengano visualizzati correttamente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Filter

Specifica il blocco di script del filtro sul lato server da applicare. Il tipo deve essere un nome di filtro valido e il valore deve essere nel formato { PropertyName <operator> "filterValue"}. Gli operatori validi sono i seguenti: -eq, -ne, -like, -notlike. Attualmente, è possibile filtrare in base a queste proprietà: Owner, Template (può essere usato per filtrare se è l'unica proprietà presente nel filtro), LockState, Url. L'uso dell'operatore -or per includere un filtro aggiuntivo non è supportato.

Nota: per i valori dell'operatore viene applicata la distinzione tra maiuscole e minuscole.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-GroupIdDefined

Filtra l'elenco dei siti restituiti ai siti con un ID gruppo (ad esempio: siti connessi a un gruppo di Microsoft 365) quando il valore è impostato su $true. Filtra l'elenco dei siti solo per i siti senza un ID gruppo quando il valore è $false.

I valori sono $true, $false e non definito. Per impostazione predefinita, il valore è non definito, il che significa che il filtro non viene applicato.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Identity

Specifica l'URL della raccolta siti.

Type:SpoSitePipeBind
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-IncludePersonalSite

Consente di visualizzare i siti personali, quando il valore è impostato su $true.

I valori validi sono $true e $false. Per impostazione predefinita, viene scelto il valore $false, in base al quale non verranno restituiti siti personali.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Limit

Specifica il numero massimo di raccolte siti da restituire. È possibile impostare un numero qualsiasi. Per recuperare tutte le raccolte siti, usare ALL. Il valore predefinito è 200. Se viene specificato questo parametro, alcune proprietà della raccolta siti non verranno popolate e potrebbero contenere un valore predefinito.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Template

Visualizza i siti di un modello specifico. Ad esempio, STS, STS#0, STS#1, STS#3, GROUP#0, SRCHCEN#0 o SITEPAGEPUBLISHING#0.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

Input

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Output

System.Object