Get-SPSiteAdministration

Модуль:

sharepoint-server

Применяется к:

SharePoint Server Subscription Edition

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

Синтаксис

Get-SPSiteAdministration
   [-Identity] <SPSiteAdministrationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSiteAdministration
   -ContentDatabase <SPContentDatabasePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]

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

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

Описание

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

Командлет Get-SPSiteAdminitration возвращает объект администрирования сайта, позволяющий администраторам ферм просматривать определенные сведения о семействе веб-сайтов, к которым у них нет доступа.

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

Примеры

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

Get-SPSiteAdministration | Select -Property Url, OwnerLoginName, @{Name="Storage";Expression={$_.Quota.StorageMaximumLevel}}

В этом примере кода происходит получение подмножества данных из всех сайтов базы данных контента с URL-адресом b399a366-d899-4cff-8a9b-8c0594ee755f (при этом администратору фермы доступ не требуется). Эта команда использует рассчитанное свойство Storage для отображения максимального значения хранилища для базы данных контента.

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

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

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

------------------EXAMPLE 3-------------------

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

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

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

Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.DiskUsed }{$sum}

Эта команда возвращает суммарное значение использования дискового пространства для всех сайтов в заданном веб-приложении.

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

Get-SPWebApplication https://sitename | Get-SPSiteAdministration -Limit ALL | Select URL

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

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

Get-SPSiteAdministration -identity "https://localserver/(my|personal)/sites" -Regex

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

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

Get-SPSite "https://sitename/sites/teams/*" -Limit 100

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

Параметры

-AssignmentCollection

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

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

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ContentDatabase

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

Тип должен быть допустимым URL-адресом в форме https://server_nameили GUID в форме 1234-456-987fg.

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

-Filter

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

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

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

-Identity

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

Типом должен быть действительный URL-адрес в виде http://имя_сервера или идентификатор GUID в виде 1234-456-987fg.

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

-Limit

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

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

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

-Regex

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

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

-SiteSubscription

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

Тип должен быть допустимым идентификатором GUID в формате 12345678-90ab-cdef-1234-567890bcdefgh, объектом или URL-адресом SPSite семейства веб-сайтов, являющегося участником подписки сайтов или экземпляром допустимого объекта SiteSubscription.

Type:	SPSiteSubscriptionPipeBind
Position:	Named
Default value:	None
Required:	True
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
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition