Partager via


Get-SPOSite

Renvoie une ou plusieurs collections de sites.

Syntaxe

ParamSet1 (Par défaut)

Get-SPOSite
    [[-Identity] <SpoSitePipeBind>]
    [-Limit <String>]
    [-Detailed]
    [-IsAuthoritative <Boolean>]
    [<CommonParameters>]

ParamSet3

Get-SPOSite
    [-Identity] <SpoSitePipeBind>
    [-DisableSharingForNonOwnersStatus]
    [<CommonParameters>]

ParamSet2

Get-SPOSite
    [-Filter <String>]
    [-Limit <String>]
    [-Detailed]
    [-Template <String>]
    [-IncludePersonalSite <Boolean>]
    [-GroupIdDefined <Boolean>]
    [-ArchiveStatus <ArchiveStatusFilterType>]
    [<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.

Les redirections de site, comme celles créées après la modification du nom de domaine SharePoint , seront récupérées à l’aide de cette applet de commande.

Vous devez être administrateur SharePoint Online et administrateur de collection de sites pour exécuter l’applet de commande.

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 renvoie l’informationSegment associée 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 -Filter { IsAuthoritative -eq true }

Cet exemple utilise le filtrage côté serveur pour renvoyer les sites faisant autorité (c’est-à-dire les sites dont la propriété IsAuthoritative est définie sur true).

EXEMPLE 9

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

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 11

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.

EXEMPLE 12

$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

-ArchiveStatus

Applicable : SharePoint Online

Affiche les sites d’un status d’archivage spécifique. Par exemple, NotArchived, RecentlyArchived, FullyArchived, Archived ou Reactivating.

Propriétés du paramètre

Type:Microsoft.Online.SharePoint.PowerShell.ArchiveStatusFilterType
Valeur par défaut:None
Valeurs acceptées:NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ParamSet2
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Detailed

Applicable : SharePoint Online

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.

Propriétés du paramètre

Type:System.Management.Automation.SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ParamSet1
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
ParamSet2
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DisableSharingForNonOwnersStatus

Applicable : SharePoint Online

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.

Propriétés du paramètre

Type:System.Management.Automation.SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ParamSet3
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Filter

Applicable : SharePoint Online

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 par les propriétés suivantes : Owner, Template (peut être utilisé pour filtrer s’il s’agit de la seule propriété présente dans le filtre), LockState, Url, IsAuthoritative (prend uniquement en charge les opérateurs de comparaison -eq et -ne). 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.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ParamSet2
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-GroupIdDefined

Applicable : SharePoint Online

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.

Propriétés du paramètre

Type:System.Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ParamSet2
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : SharePoint Online

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

Propriétés du paramètre

Type:Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ParamSet1
Position:0
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
ParamSet3
Position:0
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IncludePersonalSite

Applicable : SharePoint Online

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

Propriétés du paramètre

Type:System.Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ParamSet2
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IsAuthoritative

Applicable : SharePoint Online

Filtrez la liste des sites où la propriété IsAuthoritative a la valeur true. Lorsque IsAuthoritative est vrai, il signale à Microsoft Search, Copilot (BizChat) et à d’autres agents IA que le contenu du site est officiel, approuvé et vérifié.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ParamSet1
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Limit

Applicable : SharePoint Online

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.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ParamSet1
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False
ParamSet2
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Template

Applicable : SharePoint Online

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.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ParamSet2
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Sorties

System.Object