Get-SPSite

Синтаксис

Get-SPSite
   [-Identity] <SPSitePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   -ContentDatabase <SPContentDatabasePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [-NeedsB2BUpgrade]
   [<CommonParameters>]

Get-SPSite
   -SiteSubscription <SPSiteSubscriptionPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WebApplication <SPWebApplicationPipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Описание

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

Командлет Get-SPSite возвращает один сайт, соответствующий параметру Identity, или все сайты, соответствующие параметру Filter для заданной области. Область задается параметрами WebApplication, ContentDatabase и SiteSubscription. Если не указан ни один из них, областью является ферма. Если область указана без параметра фильтра Filter, возвращаются все сайты в данной области.

В параметре Identity можно указать частичный URL-адрес, заканчивающийся подстановочным знаком (*). Возвращаются все семейства сайтов, соответствующие этому частичному URL-адресу, для заданной области. Кроме того, если указан параметр Regex, параметр Identity считается регулярным выражением и возвращаются все семейства сайтов с указанным URL-адресом в заданной области, соответствующие этому выражению.

Параметр Filter — это серверный фильтр для определенных свойств семейства веб-сайтов, хранящихся в базе данных контента. Без параметра Filter фильтрация по этим свойствам выполняется медленно. Эти свойства семейства веб-сайтов: Owner, SecondaryContact и LockState. Параметр Filter — это блок скрипта, который использует тот же синтаксис, что и инструкция Where-Object, но выполняется на сервере для ускорения результатов.

Возможные значения свойства LockState: Unlock, NoAdditions, ReadOnly и NoAccess.

Важно помнить, что все результаты (семейства веб-сайтов), возвращаемые командлетом Get-SPSite, автоматически удаляются в конце конвейера. Чтобы сохранить результаты командлета Get-SPSite в локальной переменной, необходимо использовать командлеты Start-SPAssignment и Stop-SPAssignment, позволяющие избежать утечек памяти.

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

Примеры

------------------ПРИМЕР 1---------------------

Get-SPSite 'https://<site name>' | Get-SPWeb -Limit All | Select Title

В этом примере возвращается коллекция заголовков вложенных веб-сайтов в семействе веб-сайтов с именем> https://< сайта.

------------------ПРИМЕР 2---------------------

Get-SPSite -ContentDatabase "b399a366-d899-4cff-8a9b-8c0594ee755f" | Format-Table -Property Url, Owner, SecondaryContact

В этом примере возвращается подмножество данных со всех сайтов в базе данных контента b399a366-d899-4cff-8a9b-8c0594ee755f.

------------------ПРИМЕР 3---------------------

Start-SPAssignment -Global
$s = Get-SPSite -Identity https://<MyApp>/Sites/Site1
$s.Url
Stop-SPAssignment -Global

В этом примере возвращаются сайты, указанные с помощью параметра Identity, а результаты помещаются в переменную s.

В предыдущем примере используется метод Global семейства назначений. Метод Global проще в использовании, однако объем содержимого этого объекта быстро растет. Не рекомендуется выполнять команду Get-SPSite, возвращающую большое количество результатов, при включенном глобальном назначении.

------------------ПРИМЕР 4---------------------

$GC = Start-SPAssignment
$Sites = $GC | Get-SPSite -Filter {$_.Owner -eq "DOMAIN\JDow"} -Limit 50
Stop-SPAssignment $GC

В этом примере с помощью серверного запроса возвращаются первые 50 сайтов, владельцем которых является пользователь DOMAIN\JDow, а результаты присваиваются локальной переменной.

В примере используются расширенные методы семейства назначений.

------------------ПРИМЕР 5---------------------

Get-SPWebApplication https://<site name> | Get-SPSite -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.Usage.Storage }{$sum}

В этом примере показана команда, возвращающая суммарный объем используемого дискового пространства для всех сайтов в заданном веб-приложении.

------------------ПРИМЕР 6---------------------

Get-SPSite -Identity "https://localserver/(my|personal)/sites" -Regex

В этом примере возвращаются все сайты, соответствующие заданному регулярному выражению.

Кавычки в параметре Identity необходимы, когда используется параметр Regex.

------------------ПРИМЕР 7---------------------

Get-SPSite https://<site name>/sites/teams/* -Limit 100

В этом примере по URL-адресу показано до 100 сайтов. https://sitename/sites/teams.

------------------ПРИМЕР 8---------------------

Get-SPSite | select url, @{Expression={$_.Usage.Storage}}

В этом примере возвращается объем пространства, занятого семейством сайтов, для чего используется поле storage свойства .UsageInfo.

------------------EXAMPLE 9---------------------

Get-SPSite -Limit all -CompatibilityLevel 14

В этом примере возвращаются все семейства веб-сайтов в режиме sharePoint Server.

Параметры

-AssignmentCollection

-CompatibilityLevel

-Confirm

-ContentDatabase

-Filter

-Identity

-Limit

-NeedsB2BUpgrade

-Regex

-SiteSubscription

-WebApplication

-WhatIf