New-SPUserLicenseMapping

  • Referencia
Módulo:
SharePointServer
Se aplica a:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Crea un objeto de asignación de licencias.

Syntax

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>]

Description

Este cmdlet contiene más de un conjunto de parámetros. Solo puede usar parámetros de un conjunto y no puede combinar parámetros de conjuntos distintos. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.

Use el New-SPUserLicenseMapping cmdlet para crear un nuevo objeto de asignación de licencias. Este cmdlet debe usarse primero antes de que se pueda usar el Add-SPUserLicenseMapping cmdlet.

El objeto creado mediante el New-SPUserLicenseMapping cmdlet se almacena en memoria y no se escribe en ninguna base de datos de SharePoint Server. Una vez creado el objeto, puede canalizar el resultado al Add-SPUserLicenseMapping cmdlet .

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

----------------------- EJEMPLO---------------------------)

$a = New-SPUserLicenseMapping -SecurityGroup EntSecGroup -License Enterprise
$a | Add-SPUserLicenseMapping

En este ejemplo se crea un objeto de asignación de licencias para el grupo protegido de Active Directory denominado "EntSecGroup" y, a continuación, se canaliza el resultado al Add-SPUserLicenseMapping cmdlet .

Parámetros

-AssignmentCollection

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

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

Especifica la entidad de seguridad para notificaciones a la licencia. El valor debe ser una entidad de seguridad para notificaciones auténtica.

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

Especifica el tipo de notificación. El valor debe ser un nombre auténtico de tipo de notificación.

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

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: 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

Especifica el nombre de una licencia de usuario de SharePoint admitida. Para obtener la lista completa de licencias admitidas en una granja de servidores de SharePoint, consulte el Get-SPUserLicense cmdlet .

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

Especifica el emisor original de la notificación. El valor debe ser un nombre auténtico de emisor original.

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

Especifica el nombre de un rol basado en formularios. El valor debe ser un nombre auténtico de rol basado en formularios.

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

Especifica el nombre de un proveedor de roles. El valor debe ser un nombre auténtico de proveedor de roles.

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

Especifica el nombre de un grupo de seguridad de AD DS. El valor debe ser el nombre de un grupo de seguridad de 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

Especifica el valor de la notificación. El valor debe ser un valor de notificación auténtico.

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

Especifica el tipo de valor de la notificación. El valor debe ser un nombre auténtico de tipo de valor de notificación.

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

Especifica la dirección URL, el GUID, el nombre de aplicación web o la instancia del objeto de aplicación web al que se va a agregar la asignación. Si omite este parámetro, la asignación se aplica a toda la granja.

El tipo debe ser una dirección URL con el formatohttp://server_name o http://server_name/sites/sitename, un GUID (por ejemplo, 12345678-90ab-cdef-1234-567890bcdefgh), un nombre de aplicación web (por ejemplo, SharePoint - 80) o una instancia de un objeto de aplicación web.

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

Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando. Para obtener más información, escriba el siguiente comando: 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