Get-SPWebApplication

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

Синтаксис

Default (по умолчанию)

Get-SPWebApplication
    [[-Identity] <SPWebApplicationPipeBind>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-IncludeCentralAdministration]
    [<CommonParameters>]

Описание

Командлет Get-SPWebApplication возвращает все веб-приложения, которые соответствуют критерию, заданному с помощью параметра Identity. Параметр Identity может быть именем имени, URL-адреса или GUID веб-приложения. Если параметр Identity не указан, возвращаются все веб-приложения.

Веб-приложение центра администрирования возвращается, только если указаны его удостоверение или флаг IncludeCentralAdministration.

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

Примеры

ПРИМЕР 1

C:\PS>$w = Get-SPWebApplication https://sitename

В этом примере получается веб-приложение для https://sitename и сохраняется в переменной.

ПРИМЕР 2

Get-SPWebApplication -IncludeCentralAdministration | Where { $_.DefaultServerComment -eq "SharePoint Central Administration v4"} | Format-List *

Этот пример демонстрирует отображение всех открытых свойств веб-приложения SharePoint Central Administration в формате списка.

Параметры

-AssignmentCollection

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

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

Свойства параметра

Тип:SPAssignmentCollection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Указывает имя, URL-адрес или GUID веб-приложения.

Тип должен быть допустимым URL-адресом в форме https://server_name; GUID в форме 1234-5678-9876-0987; или допустимым именем в форме SPWebApplication - 1212.

Свойства параметра

Тип:SPWebApplicationPipeBind
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeCentralAdministration

Применимо: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Включает веб-приложение центра администрирования в семейство возвращаемых веб-приложений. При этом параметр IncludeCentral Administration должен соответствовать всем прочим заданным фильтрам.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.