New-SPUserLicenseMapping
Создает экземпляр сопоставления лицензий.
Синтаксис
New-SPUserLicenseMapping
-Claim <SPClaim>
-License <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
New-SPUserLicenseMapping
-ClaimType <String>
-License <String>
-OriginalIssuer <String>
-Value <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-ValueType <String>]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
New-SPUserLicenseMapping
-License <String>
-Role <String>
-RoleProviderName <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
New-SPUserLicenseMapping
-License <String>
-SecurityGroup <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
Описание
Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров. Совмещать параметры из разных наборов нельзя. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.
New-SPUserLicenseMapping
Используйте командлет для создания нового объекта сопоставления лицензий.
Этот командлет необходимо использовать в первую очередь перед использованием командлета Add-SPUserLicenseMapping
.
Объект, созданный с помощью командлета New-SPUserLicenseMapping
, хранится в памяти и не записывается ни в одну базу данных в SharePoint Server.
После создания объекта можно передать результат в Add-SPUserLicenseMapping
командлет.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
----------------------- ПРИМЕР---------------------------)
$a = New-SPUserLicenseMapping -SecurityGroup EntSecGroup -License Enterprise
$a | Add-SPUserLicenseMapping
В этом примере создается объект сопоставления лицензий для защищенной группы Active Directory с именем "EntSecGroup", а затем результат передается в Add-SPUserLicenseMapping
командлет .
Параметры
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Claim
Задает участника утверждений для лицензирования. Значением должен быть подлинный субъект утверждений.
Type: | SPClaim |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ClaimType
Задает тип утверждения. Значением должно быть подлинное имя типа утверждений.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-License
Указывает имя поддерживаемой пользовательской лицензии SharePoint.
Полный список поддерживаемых лицензий на ферме SharePoint см. в командлете Get-SPUserLicense
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-OriginalIssuer
Задает издателя утверждения. Значением должно быть подлинное имя исходного издателя.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Role
Задает имя роли на основе форм. Значением должно быть подлинное имя роли на основе форм.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-RoleProviderName
Задает имя поставщика ролей. Значением должно быть подлинное имя поставщика ролей.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SecurityGroup
Задает имя группы безопасности AD DS. Значением должно быть имя группы безопасности Active Directory.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Value
Задает значение утверждения. Значением должно быть подлинное значение утверждения.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ValueType
Задает тип значения утверждения. Значением должно быть подлинное имя типа значения утверждений.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WebApplication
Задает URL-адрес, GUID, имя веб-приложения или экземпляр объекта веб-приложения, в который добавляется сопоставление. Если этот параметр не определен, сопоставление применяется ко всей ферме.
The type must be an URL in the form http://server_name or http://server_name/sites/sitename, a GUID (for example, 12345678-90ab-cdef-1234-567890bcdefgh), a name of a web application (for example, SharePoint - 80), or an instance of a web application object.
Type: | SPWebApplicationPipeBind |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 2013, SharePoint Server 2016, SharePoint Server 2019 |