Get-SPOSite

Возвращает одно или несколько семейств сайтов.

Синтаксис

ParamSet1 (по умолчанию)

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

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в разделе Наборы параметров командлетов.

Командлет Get-SPOSite возвращает свойства всех семейств веб-сайтов, соответствующих заданным критериям.

В командной консоли SharePoint Online версии 5361 вы можете заметить следующее:

Теперь отображаются дополнительные семейства веб-сайтов. Например, наряду с сайтами групп будут отображаться все сайты видео и групповые сайты.

Параметр Detailed устарел. Он по-прежнему совместим с более ранними версиями.

Примечание.

Командлет Get-SPOSite не извлекает семейства веб-сайтов из корзины.

Перенаправления сайтов, например созданные после изменения доменного имени SharePoint , будут получены с помощью этого командлета.

Для выполнения командлета необходимо быть администратором SharePoint Online и администратором семейства веб-сайтов.

Сведения о разрешениях и самую последнюю информацию о Windows PowerShell для SharePoint Online см. в электронной документации Знакомство с командной консолью SharePoint Online.

Примечание.

Если для клиента включен параметр "Управление хранилищем для семейства веб-сайтов", вы не сможете задать квоту и получите общее сообщение об ошибке. Чтобы устранить эту проблему, временно задайте для управления хранилищем семейства веб-сайтов значение "вручную", установите квоты, а затем задайте для параметра управления хранилищем семейства веб-сайтов исходное значение.

Примечание.

Если указаны параметры Limit или Filter, следующие свойства семейства веб-сайтов не будут заполнены и могут содержать значение по умолчанию: AllowDownloadingNonWebViewableFiles, AllowEditing, AllowSelfServiceUpgrade, AnonymousLinkExpirationInDays, ConditionalAccessPolicy, DefaultLinkPermission, DefaultLinkToExistingAccess, DefaultSharingLinkType, DenyAddAndCustomizePages, DisableCompanyWideSharingLinks, ExternalUserExpirationInDays, InformationSegment, LimitedAccessFileType, OverrideTenantAnonymousLinkExpirationPolicy, OverrideTenantExternalUserExpirationPolicy, PWAEnabled, SandboxedCodeActivationCapability, SensitivityLabel, SharingAllowedDomainList, SharingBlockedDomainList, SharingCapability, SharingDomainRestrictionMode.

Примеры

ПРИМЕР 1

Get-SPOSite

В примере 1 возвращаются все семейства веб-сайтов.

ПРИМЕР 2

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

В примере 2 выводится семейство веб-сайтов с подробными свойствами.

ПРИМЕР 3

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

В примере 3 обновляется состояние о том, могут ли пользователи, не являющиеся владельцами семейства веб-сайтов, совместно использовать семейство веб-сайтов (само значение не устанавливается).

ПРИМЕР 4

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

Этот пример командлета перечисляет семейства веб-сайтов группы в клиенте.

ПРИМЕР 5

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

Этот пример командлета получает сведения о квоте для сайта группы.

ПРИМЕР 6

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

В этом примере возвращается объект InformationSegment, связанный с сайтом. Он применим только для клиентов, у которых включена функция информационных барьеров Microsoft 365. Ознакомьтесь с разделом Сведения об информационных барьерах, чтобы понять информационные барьеры в SharePoint Online.

Примечание. Это свойство доступно только в командная консоль SharePoint Online версии 16.0.19927.12000 или более поздней.

ПРИМЕР 7

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

В этом примере используется фильтрация на стороне сервера для возврата сайтов, совпадающих с 18.

ПРИМЕР 8

Get-SPOSite -Filter { IsAuthoritative -eq true }

В этом примере используется фильтрация на стороне сервера для возврата полномочных сайтов (т. е. сайтов, для которых свойству IsAuthoritative присвоено значение true).

ПРИМЕР 9

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

В этом примере используется фильтрация на стороне клиента для возврата списка сайтов, подключенных к Microsoft Teams.

ПРИМЕР 10

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

В этом примере используется фильтрация на стороне клиента для возврата списка сайтов, подключенных к закрытому или общему каналу Microsoft Teams.

ПРИМЕР 11

Get-SPOSite -Limit ALL -GroupIdDefined $true

В этом примере используется фильтрация на стороне сервера для возврата всех сайтов, с которыми связана группа Microsoft 365.

ПРИМЕР 12

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

В этом примере извлекается фильтрация всех сайтов по указанному владельцу с помощью переменной.

Параметры

-ArchiveStatus

Применимо: SharePoint Online

Отображает сайты с определенным состоянием архива. Например, NotArchived, RecentlyArchived, FullyArchived, Archived или Reactivating.

Свойства параметра

Тип:Microsoft.Online.SharePoint.PowerShell.ArchiveStatusFilterType
Default value:None
Допустимые значения:NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ParamSet2
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Detailed

Применимо: SharePoint Online

Этот параметр позволяет получить дополнительные сведения о свойствах семейства сайтов. При использовании параметра Detailed работа командлета замедляется.

Возвращаются следующие свойства:

  • ResourceUsageCurrent
  • ResourceUsageAverage
  • StorageUsageCurrent
  • LockIssue
  • WebsCount
  • CompatibilityLevel
  • AllowSelfServiceUpgrade
  • SiteDefinedSharingCapability

Возвращает сохраненное значение политики сайта.

  • SharingCapability

Возвращает фактический уровень доступа на основе политики сайта и политики клиента.

Свойства параметра

Тип:System.Management.Automation.SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ParamSet1
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ParamSet2
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisableSharingForNonOwnersStatus

Применимо: SharePoint Online

Этот параметр запрещает пользователям, не являющимся владельцами, предоставлять кому-либо доступ.

Примечание.

Этот параметр доступен только в командной консоли SharePoint Online версии 16.0.4613.1211 или более поздней. DisableSharingForNonOwnersStatus — это не сохраненный параметр, а скорее анализ состояния семейства веб-сайтов. Это предназначено для получения этого параметра, и это не гарантирует правильность возвращаемых других параметров. Чтобы получить другие параметры и значения, используйте Get-SPOSite без этого параметра, чтобы убедиться, что все отображается правильно.

Свойства параметра

Тип:System.Management.Automation.SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ParamSet3
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Filter

Применимо: SharePoint Online

Задает блок сценария фильтра на стороне сервера, который требуется применить. Тип должен быть допустимым именем фильтра, а значение должно иметь формат { PropertyName <operator> "filterValue"}. Допустимые операторы: -eq, -ne, -like, -notlike. В настоящее время можно выполнить фильтрацию по следующим свойствам: Owner, Template (можно использовать для фильтрации, если это единственное свойство в фильтре), LockState, URL-адрес, IsAuthoritative (поддерживает только операторы сравнения -eq и -ne). Использование оператора -or для включения дополнительного фильтра не поддерживается.

Примечание. Значения операторов вводятся с учетом регистра.

Свойства параметра

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ParamSet2
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GroupIdDefined

Применимо: SharePoint Online

Отфильтровывает в списке возвращаемых сайтов сайты с идентификатором группы (например, сайты, подключенные к группе Microsoft 365), если установлено значение $true. Отфильтровывает в списке сайтов только сайты без идентификатора группы, если установлено значение $false.

Допустимые значения — $true, $false и not defined. По умолчанию для этого параметра установлено значение not defined, что означает, что фильтр не применяется.

Свойства параметра

Тип:System.Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ParamSet2
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: SharePoint Online

Задает URL-адрес семейства веб-сайтов.

Свойства параметра

Тип:Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ParamSet1
Position:0
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ParamSet3
Position:0
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludePersonalSite

Применимо: SharePoint Online

Задайте значение $true, чтобы отобразить личные сайты.

Допустимые значения — $true и $false. По умолчанию задано значение $false, поэтому личные сайты не возвращаются.

Свойства параметра

Тип:System.Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ParamSet2
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IsAuthoritative

Применимо: SharePoint Online

Отфильтруйте список сайтов, для которых свойству IsAuthoritative присвоено значение true. Если isAuthoritative имеет значение true, он сигнализирует Microsoft Search, Copilot (BizChat) и другим агентам ИИ о том, что содержимое сайта является официальным, доверенным и проверенным.

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ParamSet1
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Limit

Применимо: SharePoint Online

Задает максимальное количество возвращаемых семейств сайтов. Это количество может быть любым. Для возврата всех семейств веб-сайтов используйте значение "ALL". Значение по умолчанию: 200. Если этот параметр задан, некоторые свойства семейства веб-сайтов не будут заполнены и могут содержать значение по умолчанию.

Свойства параметра

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ParamSet1
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ParamSet2
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Template

Применимо: SharePoint Online

Отображает сайты, основанные на определенном шаблоне. Например, STS, STS#0, STS#1, STS#3, GROUP#0, SRCHCEN#0 или SITEPAGEPUBLISHING#0.

Свойства параметра

Тип:System.String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

ParamSet2
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

Входные данные

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Выходные данные

System.Object