Commentaires

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 plusieurs jeux de paramètres. Vous ne pouvez utiliser que des paramètres d’un seul jeu de paramètres et vous ne pouvez pas combiner des paramètres de différents jeux de paramètres. Pour plus d’informations sur l’utilisation des jeux de paramètres, consultez la rubrique Jeux de paramètres de l’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:

Des 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 a été déconseillé. Il continuera à fonctionner avec des versions antérieures.

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

Si la gestion de stockage de la collection 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 de stockage de la collection de sites sur «manuelle», définissez vos quotas et définissez le paramètre de gestion de stockage de la collection de sites sur sa valeur d’origine.

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é

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

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