Get-SPOSite

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

This cmdlet contains more than one parameter set. You may only use parameters from one parameter set and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet Parameter Sets.

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:

Additional site collections are now displayed. For example, all group and video sites along with team sites will be displayed.

The Detailed parameter has been deprecated. It will continue to work with earlier versions

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

If Site Collection Storage Management is enabled for the tenant, you will not be able to set quota and will have a generic error returned. To workaround this issue, set the site collection storage management to "manual" temporarily, set your quotas and then set the site collection storage management setting back to its original setting.

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

Use this parameter to get additional property information on a site collection. You will notice a slower response time when the Detailed parameter is used.

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
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.

Type:SwitchParameter
Position:Named
Default value:None
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
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
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
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.

The values are $true and $false. By default, the value is $false which means no personal sites will be returned.

Type:Boolean
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

Input

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Output

System.Object