Get-SPOSite
Возвращает одно или несколько семейств сайтов.
Синтаксис
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
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по