Get-SPOSite

Renvoie une ou plusieurs collections de sites.

Syntax

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

Description

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.

La Get-SPOSite cmdlet récupère et renvoie les propriétés de toutes les collections de sites correspondant aux critères donnés.

Avec la version 5361 de SharePoint Online Management Shell, vous pouvez rencontrer les éléments suivants:

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

Notes

Les collections de sites dans la Corbeille ne sont pas récupérées par l’utilisation de la cmdlet Get-SPOSite.

Vous devez être administrateur Microsoft Office SharePoint Online, ou un administrateur général et être un administrateur de collection de sites pour exécuter cette cmdlet.

Pour les autorisations et informations les plus récentes sur Windows PowerShell pour SharePoint Online, consultez la documentation en ligne sur Présentation de SharePoint Online Management Shell.

Notes

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.

Notes

Si les paramètres Limit ou Filter sont fournis, les propriétés de collection de sites suivantes ne sont pas renseignées et peuvent contenir une valeur par défaut : AllowDownloadingNonWebViewableFiles, AllowEditing, AllowSelfServiceUpgrade, AnonymousLinkExpirationInDays, ConditionalAccessPolicy, DefaultLinkPermission, DefaultLinkToExistingAccess, DefaultSharingLinkType, DenyAddAndCustomizePages, DisableCompanyWideSharingLinks, ExternalUserExpirationInDays, InformationSegment, LimitedAccessFileType, OverrideTenantAnonymousLinkExpirationPolicy, OverrideTenantExternalUserExpirationPolicy, PWAEnabled, SandboxedCodeActivationCapability, SensitivityLabel, SharingAllowedDomainList, SharingBlockedDomainList, SharingCapability, SharingDomainRestrictionMode.

Exemples

-----------------------EXEMPLE 1-----------------------------

Get-SPOSite

L’exemple 1 retourne toutes les collections de sites.

-----------------------EXEMPLE 2-----------------------------

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

L’exemple 2 répertorie la collection de sites avec les propriétés détaillées.

-----------------------EXEMPLE 3-----------------------------

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

L’exemple 3 met à jour l’état si les non-propriétaires d’une collection de sites peuvent partager la collection de sites (ne définit pas cette valeur).

-----------------------EXEMPLE 4-----------------------------

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

Cet exemple énumère les collections de sites de groupe d’un client.

-----------------------EXEMPLE 5-----------------------------

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

Cet exemple obtient les détails des quotas pour un site de groupe.

-----------------------EXEMPLE 6-----------------------------

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

Cet exemple retourne les InformationsSegments associées au site. Il s’applique aux locataires qui ont activé Microsoft 365 Obstacles aux informations. En savoir plus sur les obstacles à l’information pour comprendre les obstacles à l’information dans SharePoint Online.

Remarque : cette propriété est disponible uniquement dans SharePoint Online Management Shell version 16.0.19927.12000 ou ultérieure.

-----------------------EXEMPLE 7-----------------------------

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

Cet exemple utilise le filtrage côté serveur pour retourner des sites correspondant à 18.

-----------------------EXEMPLE 8-----------------------------

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

Cet exemple utilise le filtrage côté client pour retourner une liste de sites connectés à Microsoft Teams.

-----------------------EXEMPLE 9-----------------------------

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

Cet exemple utilise le filtrage côté client pour retourner une liste de sites connectés à un canal privé ou partagé Microsoft Teams.

-----------------------EXEMPLE 10-----------------------------

Get-SPOSite -Limit ALL -GroupIdDefined $true

Cet exemple utilise le filtrage côté serveur pour retourner tous les sites associés à un groupe Microsoft 365.

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

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

Cet exemple récupère tous les sites filtrés par le propriétaire spécifié à l’aide d’une variable.

Paramètres

-Détaillé

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.

Les propriétés suivantes sont renvoyées:

  • ResourceUsageCurrent

  • ResourceUsageAverage

  • StorageUsageCurrent

  • LockIssue

  • WebsCount

  • CompatibilityLevel

  • AllowSelfServiceUpgrade

  • SiteDefinedSharingCapability

Retourne la valeur stockée de la stratégie de site.

  • SharingCapability

Retourne le niveau d’accès effectif, qui est la stratégie de site et la stratégie de client combinées.

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

-DisableSharingForNonOwnersStatus

Ce paramètre empêche le partage par des personnes non propriétaires.

Notes

Ce paramètre est disponible uniquement dans SharePoint Online Management Shell, version 16.0.4613.1211 ou ultérieure.

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

-Filtrer

Spécifie le bloc de script du filtre côté serveur à appliquer. Le type doit être un nom de filtre valide et la valeur doit être au format { PropertyName <operator> "filterValue"}. Les opérateurs valides sont les suivants: eq, ne, like, notlike. Actuellement, vous pouvez filtrer en fonction des propriétés suivantes: Propriétaire, Modèle (peut être utilisé pour filtrer s’il s’agit de la seule propriété présente dans le filtre), LockState, URL. L’utilisation de l’opérateur -ou pour inclure un filtre supplémentaire qui n’est pas prise en charge.

Remarque: Les valeurs de l’opérateur respectent la casse.

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

-GroupIdDefined

Filtre la liste des sites retournés aux sites avec un ID de groupe (par exemple: sites connectés à un groupe Microsoft 365) lorsque la valeur est définie sur $true. Filtre la liste des sites sur uniquement les sites sans ID de groupe lorsque la valeur est $false.

Les valeurs sont $true, $false, et non défini. Par défaut, la valeur est non défini, ce qui signifie que le filtre ne s’applique pas.

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

-Identité

Spécifie l'URL de la collection de sites.

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

-IncludePersonalSite

Affiche les sites personnels lorsque la valeur est définie sur $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

-Limite

Spécifie le nombre maximal de collections de sites à renvoyer. Il peut s'agir d'un nombre quelconque. Pour récupérer toutes les collections de sites, utilisez ALL. La valeur par défaut est 200. Si ce paramètre est fourni, certaines propriétés de collection de sites ne seront pas remplies et peuvent contenir une valeur par défaut.

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

-Modèle

Affiche les sites d’un modèle spécifique. Par exemple, STS, STS#0, STS#1, STS#3, GROUP#0, SRCHCEN#0 ou SITEPAGEPUBLISHING#0.

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

Entrées

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Sorties

System.Object