Поделиться через

Get-SPOSite

  • Ссылка
Модуль:
Microsoft.Online.SharePoint.PowerShell
Применяется к:
SharePoint Online

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

Синтаксис

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

Описание

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

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

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

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

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

Примечание.

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

Для запуска командлета необходимо быть глобальным администратором или администратором 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

В этом примере возвращаются данные InformationSegments, связанные с сайтом. Он применим только для клиентов, у которых включена функция информационных барьеров 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 -Limit ALL | ?{$_.IsTeamsConnected -eq $true}

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

-----------------------ПРИМЕР 9-----------------------------

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

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

-----------------------ПРИМЕР 10-----------------------------

Get-SPOSite -Limit ALL -GroupIdDefined $true

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

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

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

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

Параметры

-Detailed

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

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

  • ResourceUsageCurrent

  • ResourceUsageAverage

  • StorageUsageCurrent

  • LockIssue

  • WebsCount

  • CompatibilityLevel

  • AllowSelfServiceUpgrade

  • SiteDefinedSharingCapability

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

  • SharingCapability

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

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

-DisableSharingForNonOwnersStatus

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

Примечание.

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

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

-Filter

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

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

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

-GroupIdDefined

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

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

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

-Identity

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

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

-IncludePersonalSite

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

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

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

-Limit

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

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

-Template

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

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

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

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

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

System.Object