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
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-SPOSiteNell'esempio 1 vengono restituite tutte le raccolte siti.
-----------------------ESEMPIO 2-----------------------------
Get-SPOSite -Identity https://contoso.sharepoint.comNell'esempio 2 viene elencata la raccolta siti con le proprietà dettagliate.
-----------------------ESEMPIO 3-----------------------------
Get-SPOSite -Identity https://contoso.sharepoint.com -DisableSharingForNonOwnersStatusNell'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:$falseIn questo esempio le raccolte siti del gruppo vengono enumerate in un tenant.
-----------------------ESEMPIO 5-----------------------------
Get-SPOSite -Identity https://contoso.sharepoint.com/sites/groupname -detailed |flIn questo esempio si ottengono dettagli per il sito del gruppo.
-----------------------ESEMPIO 6-----------------------------
Get-SPOSite -Identity https://contoso.sharepoint.com/sites/research | Select InformationSegmentIn 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 $trueIn 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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per