New-SPUserLicenseMapping
Crea un objeto de asignación de licencias.
Sintaxis
TrustIdentity
New-SPUserLicenseMapping
-Claim <SPClaim>
-License <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
ClaimsValues
New-SPUserLicenseMapping
-ClaimType <String>
-License <String>
-OriginalIssuer <String>
-Value <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-ValueType <String>]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
FormsAuth
New-SPUserLicenseMapping
-License <String>
-Role <String>
-RoleProviderName <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[<CommonParameters>]
WindowsAuth
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
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | SPAssignmentCollection |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Claim
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica la entidad de seguridad para notificaciones a la licencia. El valor debe ser una entidad de seguridad para notificaciones auténtica.
Propiedades del parámetro
| Tipo: | SPClaim |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
TrustIdentity
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ClaimType
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el tipo de notificación. El valor debe ser un nombre auténtico de tipo de notificación.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ClaimsValues
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Le pide confirmación antes de ejecutar el comando.
Para obtener más información, escriba el siguiente comando: get-help about_commonparameters
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-License
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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 .
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-OriginalIssuer
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el emisor original de la notificación. El valor debe ser un nombre auténtico de emisor original.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ClaimsValues
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Role
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el nombre de un rol basado en formularios. El valor debe ser un nombre auténtico de rol basado en formularios.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FormsAuth
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-RoleProviderName
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el nombre de un proveedor de roles. El valor debe ser un nombre auténtico de proveedor de roles.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
FormsAuth
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-SecurityGroup
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
WindowsAuth
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Value
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el valor de la notificación. El valor debe ser un valor de notificación auténtico.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ClaimsValues
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ValueType
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica el tipo de valor de la notificación. El valor debe ser un nombre auténtico de tipo de valor de notificación.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
ClaimsValues
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WebApplication
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propiedades del parámetro
| Tipo: | SPWebApplicationPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.