Set-SPExcelUserDefinedFunction

Ссылка

Модуль:: SharePointServer

Применяется к:: SharePoint Server 2010, SharePoint Server 2013

Задает свойства пользовательской функции в приложении служб Excel.

Синтаксис

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 с именем My Excel Service.

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

Get-SPExcelServiceApplication "My Excel Service" | Set-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf -Enable: $false

В этом примере отключается пример файла UDF SampleCompany.SampleApplication.SampleUdf из приложения службы Excel с именем My Excel Service.

Параметры

-Assembly

Указывает строго типизированное имя сборки. Имя должно быть уникальным в списке определяемых пользователем функций и не может содержать более 4096 буквенно-цифровых символов.

Типом должна быть строка буквенно-цифровых символов (например, SampleCompany.SampleApplication.SampleUdf, C:\UDFs\SampleUdf.dll или \\MyNetworkServer\UDFs\SampleUdf.dll).

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

-AssemblyLocation

Указывает расположение, где хранится сборка.

Типом должно быть одно из следующих значений: 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.

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, содержащее объект списка SPExcelUserDefinedFunction.

Тип должен быть допустимым ИДЕНТИФИКАТОРом 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

-Identity

Указывает объект SPExcelUserDefinedFunction, который необходимо обновить.

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

Type:	SPExcelUDFPipeBind
Position:	1
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

Поделиться через