Get-SPOSite

  • Référence
Module:
Microsoft.Online.SharePoint.PowerShell
S’applique à:
SharePoint Online

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

Cette applet de commande contient plus d’un jeu de paramètres. Vous ne pouvez utiliser les paramètres que d’un seul jeu et vous ne pouvez pas combiner les paramètres de différents jeux. Pour plus d’informations sur l’utilisation des jeux de paramètres, consultez Ensembles de paramètres d’applet de commande.

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:

les collections de sites supplémentaires sont à présent affichées. Par exemple, tous les sites de groupes et de vidéos, ainsi que les sites d’équipe seront affichés.

Le paramètre Detailed est obsolète. Il fonctionnera encore avec les versions antérieures.

Remarque

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.

Remarque

Si la gestion de stockage de la collections de sites est activée pour le client, vous ne pourrez pas définir de quota et une erreur générique sera renvoyée. Pour contourner ce problème, définissez temporairement la gestion du stockage de la collection de sites sur « manuelle », définissez vos quotas, puis rétablissez le paramètre de gestion du stockage de la collection de sites sur son paramètre d’origine.

Remarque

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és au site. Il s’applique aux locataires qui ont activé Microsoft 365 Obstacles aux informations. Lisez 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 filtrant par le propriétaire spécifié à l’aide d’une variable.

Paramètres

-Detailed

Utilisez ce paramètre pour obtenir des informations supplémentaires sur les propriétés d'une collection de sites. Vous observerez que le temps de réponse est plus lent lorsque le paramètre Detailed est utilisé.

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
Required:False
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.

Remarque

Ce paramètre est disponible uniquement dans SharePoint Online Management Shell, version 16.0.4613.1211 ou ultérieure. DisableSharingForNonOwnersStatus n’est pas un paramètre persistant, mais plutôt une analyse de l’état de la collection de sites. L’objectif est d’obtenir ce paramètre, et il n’est pas garanti que les autres paramètres retournés soient corrects. Pour obtenir d’autres paramètres et valeurs, utilisez la Get-SPOSite sans ce paramètre pour vous assurer que tout s’affiche correctement.

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

-Filter

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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Identity

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

Type:SpoSitePipeBind
Position:0
Default value:None
Required:False
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.

Les valeurs sont $true et $false. Par défaut, la valeur est $false, ce qui signifie qu’aucun site personnel n’est renvoyé.

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

-Limit

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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Template

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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

Entrées

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Sorties

System.Object