Set-SPExcelUserDefinedFunction
Задает свойства пользовательской функции в приложении служб Excel.
Синтаксис
Default (По умолчанию)
Set-SPExcelUserDefinedFunction
[-Identity] <SPExcelUDFPipeBind>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-Assembly <String>]
[-AssemblyLocation <AssemblyLocation>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-Enable]
[-WhatIf]
[<CommonParameters>]
Описание
Командлет Set-SPExcelUserDefinedFunction задает свойства пользовательской сборки функции.
В приложении службы Excel используются только пользовательские функции, включенные в список функций, определенных пользователем.
Пользовательские функции — это сборки управляемого кода, которые можно вызвать из книги приложения службы Excel, используя стандартный синтаксис формулы приложения службы Excel.
Сборки могут выполнять заданные пользователем логические и иные операции, например обновление данных.
Командлеты Windows PowerShell работают с записями в списке пользовательских функций, но не с самими сборками.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
ПРИМЕР 1
Set-SPExcelUserDefinedFunction -ExcelServiceApplication "My Excel Service" -Identity SampleCompany.SampleApplication.SampleUdf -Description "This is the new description for the sample UDF"
В этом примере описание пользовательской функции (UDF) изменяется на пользовательский файл UDF SampleCompany.SampleApplication.SampleUdf для веб-приложения приложения службы Excel с именем "Моя служба Excel".
ПРИМЕР 2
Get-SPExcelServiceApplication "My Excel Service" | Set-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf -Enable: $false
В этом примере отключается образец пользовательского файла SampleCompany.SampleApplication.SampleUdf из приложения службы Excel с именем "Моя служба Excel".
Параметры
-Assembly
Применимо: SharePoint Server 2010 и SharePoint Server 2013
Указывает строго типизированное имя сборки. Имя должно быть уникальным в списке пользовательских функций и не должно превышать 4096 букв и цифр.
Типом должна быть строка буквенно-цифровых символов (например, SampleCompany.SampleApplication.SampleUdf, C:\UDFs\SampleUdf.dll или \\MyNetworkServer\UDFs\SampleUdf.dll).
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-AssemblyLocation
Применимо: SharePoint Server 2010 и SharePoint Server 2013
Указывает расположение, где хранится сборка.
Типом должно быть одно из следующих значений: GAC или LocalFile.
Свойства параметров
| Тип: | AssemblyLocation |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-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 |
-Confirm
Применимо: SharePoint Server 2010 и SharePoint Server 2013
Предлагает подтвердить выполнение команды.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Description
Применимо: SharePoint Server 2010 и SharePoint Server 2013
Указывает отображаемое описание пользовательской функции. Имя может содержать не более 4096 буквенно-цифровых символов.
Типом должна быть строка буквенно-цифровых символов (например, "Пользовательская функция для консолидированных отчетов").
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Enable
Применимо: SharePoint Server 2010 и SharePoint Server 2013
Активация пользовательской функции для использования с приложением службы Excel.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | 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
Указывает объект SPExcelUserDefinedFunction, который необходимо обновить.
Типом должно быть действительное имя сборки кода (например, SampleCompany.SampleApplication.SampleUdf) или экземпляр действительного объекта SPExcelUDF.
Свойства параметров
| Тип: | SPExcelUDFPipeBind |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: SharePoint Server 2010 и SharePoint Server 2013
Отображает описание команды. При этом сама команда не выполняется.
Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.