New-SPExcelUserDefinedFunction
Добавляет новую пользовательскую функцию в приложение служб Excel.
Синтаксис
New-SPExcelUserDefinedFunction
-Assembly <String>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AssemblyLocation <AssemblyLocation>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-Enable]
[-WhatIf]
[<CommonParameters>] Описание
Командлет New-SPExcelUserDefinedFunction добавляет определяемую пользователем функцию в приложение веб-службы приложения службы Excel.
службы Excel приложение использует только определяемые пользователем функции, которые имеют запись в списке определяемых пользователем функций.
Определяемые пользователем функции — это управляемые сборки кода, которые можно вызывать из книги приложения службы Excel с помощью стандартного синтаксиса формулы приложения службы Excel.
Сборки могут выполнять заданные пользователем логические и иные операции, например обновление данных.
Командлеты Windows PowerShell работают с записями в списке пользовательских функций, но не с самими сборками.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
------------------ПРИМЕР------------------
Get-SPExcelServiceApplication | New-SPExcelUserDefinedFunction -Assembly "SampleCompany.SampleApplication.SampleUdf" -AssemblyLocation GACВ этом примере файл SampleComany.SampleApplication.SampleUdf добавляется в каждое приложение веб-службы приложения службы Excel в ферме.
Сборка пользовательских функций развертывается в глобальном кэше сборок (GAC).
Параметры
-Assembly
Указывает строго типизированное имя сборки. Имя должно быть уникальным в списке пользовательских функций. Длина имени не должна превышать 4096 знаков.
Типом должна быть допустимая строка буквенно-цифровых символов, например:
- SampleCompany.SampleApplication.SampleUdf -- C:\UDFs\SampleUdf.dll -- \\MyNetworkServer\UDFs\SampleUdf.dll
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-AssemblyLocation
Указывает место хранения сборки. Значение по умолчанию: GAC.
Типом должно быть одно из следующих значений: GAC или LocalFile.
| Type: | AssemblyLocation |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-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 |
-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 |
-Description
Указывает понятное описание пользовательской функции. Длина имени не должна превышать 4096 знаков. Значение по умолчанию: пустая строка.
Типом должна быть допустимая строка буквенно-цифровых символов (например, "Пользовательская функция для консолидированных отчетов").
| 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 |
-Enable
Активирует определяемую пользователем функцию для использования с приложением службы Excel. Значение по умолчанию — True.
| 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 |
-ExcelServiceApplication
Указывает приложение веб-службы приложения службы Excel, содержащее список определяемых пользователем функций.
Тип должен быть допустимым ИДЕНТИФИКАТОРом GUID в форме 12345678-90ab-cdef-1234-567890bcdefgh; допустимое имя приложения веб-службы приложения службы Excel в ферме (например, MyExcelService1) или экземпляр допустимого объекта SPExcelServiceApplication.
| Type: | SPExcelServiceApplicationPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-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 |