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

Описание

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

The Get-SPSite cmdlet returns either a single site that matches the Identity parameter, or all the sites that match the Filter parameter for the specified scope. The scopes are the WebApplication, ContentDatabase , and SiteSubscription parameters. If none of these scopes is provided, the scope is the farm. If the scope is specified with no Filter parameter, all sites in that scope are returned.

The Identity parameter supports providing a partial URL that ends in a wildcard character (*). All site collections that match this partial URL for the specified scope are returned. Additionally, if the Regex parameter is provided, the Identity parameter is treated as a regular expression and any site collection with a URL provided in the given scope that matches the expression is returned.

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

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

It is important to note that every site collection that the Get-SPSite cmdlet returns is automatically destroyed at the end of the pipeline. To store the results of Get-SPSite in a local variable, use the Start-SPAssignment and Stop-SPAssignment cmdlets to avoid memory leaks.

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

Примеры

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

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

Этот пример возвращает коллекцию дочерних веб-сайтов в семействе веб-сайтов по адресу https://<site name>.

------------------ПРИМЕР 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.

The previous example uses the Global method of assignment collection. The Global method is easy to use but the contents of this object grows quickly. Be careful not to run a Get-SPSite command that returns many results while global assignment is enabled.

------------------ПРИМЕР 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

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-CompatibilityLevel

Определяет версию шаблонов, которая используется при создании нового объекта SPSite. Это значение устанавливает начальный уровень совместимости для семейства сайтов. Значения этого параметра могут быть sharePoint Server или SharePoint Server. Если он не указан, для CompatibilityLevel по умолчанию задается последняя доступная версия веб-приложения в соответствии с параметром SiteCreationMode.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ContentDatabase

Задает идентификатор GUID базы данных контента, для которой требуется вернуть семейства сайтов.

Тип значения: допустимое имя базы данных, например SPContentDB01, или допустимый идентификатор GUID в формате 12345678-90ab-cdef-1234-567890bcdefgh.

Type:SPContentDatabasePipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Filter

Задает блок сценария фильтра на стороне сервера, который требуется применить.

Тип должен быть допустимым именем фильтра и значением в форме {$_PropertyName <operator> "filterValue"}.

Допустимые операторы: EQ, NE, LIKE, NOTLIKE.

Type:ScriptBlock
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Identity

Задает URL-адрес или идентификатор GUID семейства сайтов, которое требуется получить.

Тип должен быть допустимым URL-адресом в форме или https://server_name https://server_name/sites/sitenameдопустимым GUID (например, 12345678-90ab-cdef-1234-567890bcdefgh).

Type:SPSitePipeBind
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Limit

Задает максимальное число возвращаемых семейств сайтов. Значение по умолчанию: 200.

Тип значения: допустимое неотрицательное число. Чтобы вернуть все семейства сайтов в заданной области, укажите значение ALL.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-NeedsB2BUpgrade

Определяет, следует ли обновлять веб-сайт.

Допустимые значения: True и False.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Regex

Если задан этот параметр, URL-адрес, указанный в параметре Identity, считается регулярным выражением.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SiteSubscription

Указывает подписку, для которой требуется вернуть семейства сайтов.

Тип должен быть допустимым URL-адресом https://server_name в форме или допустимым GUID (например, 12345678-90ab-cdef-1234-567890bcdefgh).

Type:SPSiteSubscriptionPipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WebApplication

Определяет URL-адрес, идентификатор GUID или имя веб-приложения, для которого требуется вернуть сайты.

Тип должен быть допустимым URL-адресом в форме, https://server_nameдопустимым GUID (например, 12345678-90ab-cdef-1234-567890bcdefgh) или именем веб-приложения (например, WebApplication1212).

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition