Get-SPWeb

Возвращает все дочерние сайты, подходящие под заданные условия.

Синтаксис

Get-SPWeb
   [[-Identity] <SPWebPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-Site <SPSitePipeBind>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Командлет Get-SPWeb возвращает все дочерние сайты, подходящие под область действия, заданную параметром Identity. Возвращаются все дочерние сайты, подходящие под заданные условия.

The Identity can be either the full URL or a relative path. If you specify a relative path, you must also specify the Site parameter to identify the site collection from which to return the subsite.

The Identity parameter also supports providing a partial URL that ends in a wildcard character (*). All subsites 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 subweb with a URL provided in the given scope that matches the expression is returned.

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

It is important to note that every site collection returned by the Get-SPWeb cmdlet is automatically disposed of at the end of the pipeline. To store the results of Get-SPWeb in a local variable, the Start-SPAssignment and Stop-SPAssignment cmdlets must be used to avoid memory leaks.

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

Примеры

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

Get-SPWeb -site https://sitename/sites/site1

В данном примере кода возвращаются все дочерние веб-сайты в заданном семействе веб-сайтов.

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

Get-SPWeb -Site https://sitename/sites/site1  -filter {$_.Template -eq "STS#0"}

В данном примере кода отображаются все дочерние сайты, использующие шаблон "STS#0".

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

Start-SPAssignment -Global
$w = Get-SPWeb https://sitename
$w.set_SiteLogoUrl("https://PathToImage/test.jpg")
$w.Update()
Stop-SPAssignment -Global

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

Параметры

-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

-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

-Filter

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

The type must be a valid filter in the form {filterName <operator> "filterValue"}.

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

-Identity

Задает имя либо полный или сокращенный URL-адрес дочернего сайта. При использовании относительного пути необходимо задать параметр Site.

Допустимый URL-адрес в формате http://имя_сервера или относительный путь в формате /SubSites/MySubSite.

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

-Limit

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

Тип должен быть допустимым числом больше 0 или значением ALL.

Type:String
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

-Site

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

Тип должен быть допустимым URL-адресом https://server_nameв формате ; GUID в форме 1234-5678-9807 или объектом SPSite.

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

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: 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