Get-SPExcelUserDefinedFunction

Возвращает пользовательскую функцию или набор пользовательских функций.

Синтаксис

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

Get-SPExcelUserDefinedFunction
    [[-Identity] <SPExcelUDFPipeBind>]
    -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [<CommonParameters>]

Описание

Командлет Get-SPExcelUserDefinedFunction считывает пользовательскую функцию и ее свойства или возвращает коллекцию пользовательских функций для приложения веб-службы службы Excel Application. В приложении службы Excel используются только пользовательские функции, перечисленные в списке пользовательских функций. Пользовательские функции — это сборки управляемого кода, которые можно вызвать из книги приложения службы Excel, используя стандартный синтаксис формулы приложения службы Excel. Сборки могут выполнять пользовательскую логику или другие действия, например обновлять данные. Командлеты Windows PowerShell оперируют записями в пользовательском списке функций, но не со сборками.

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

Примеры

ПРИМЕР 1

Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf

В этом примере отображается пользовательская функция SampleCompany.SampleApplication.SampleUdf из списка пользовательских функций приложения приложения службы Excel с именем MyExcelService.

ПРИМЕР 2

Get-SPExcelServiceApplication | Get-SPExcelUserDefinedFunction | format-list

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

Параметры

-AssignmentCollection

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

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

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

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

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

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

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

-ExcelServiceApplication

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

Указывает приложение веб-службы службы Excel, содержащее объект списка SPExcelUserDefinedFunction.

Тип должен быть допустимым GUID в формате 12345678-90ab-cdef-1234-567890bcdefgh; Допустимое имя приложения веб-службы службы Excel в ферме (например, MyExcelService1); или экземпляр допустимого объекта SPExcelServiceApplication.

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

Тип:SPExcelServiceApplicationPipeBind
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

-Identity

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

Указывает объект UserDefinedFunction, который нужно получить. Если параметр Identity не указан, командлет возвращает все функции из списка пользовательских функций.

Тип должен быть допустимым именем сборки кода (например, SampleCompany.SampleApplication.SampleUdf); или экземпляр допустимого объекта SPExcelUDF.

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

Тип:SPExcelUDFPipeBind
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

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

CommonParameters

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