Get-SPSiteAdministration
Возвращает объект администрации сайта, позволяющий администраторам фермы просматривать определенную информацию о семействе веб-сайтов, к которым у них нет доступа.
Синтаксис
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-------------------
C:\PS>$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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Filter
Задает блок сценария фильтра на стороне сервера, который требуется применить.
Тип должен быть допустимым именем фильтра и значением в формате { $_ Оператор > PropertyName <"filterValue"}}
Type: | ScriptBlock |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Limit
Задает максимальное число возвращаемых семейств сайтов. Значение по умолчанию: 200.
Тип значения: допустимое неотрицательное число. Чтобы возвращать все семейства сайтов в заданной области, укажите значение ALL.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Regex
Если этот параметр включен, URL-адрес, указанный в параметре Identity, считается регулярным выражением.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |