New-SPUserLicenseMapping

Erstellt ein Objekt für eine Lizenzzuordnung.

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

Beschreibung

This cmdlet contains more than one parameter set. You may only use parameters from one parameter set and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet parameter sets.

Verwenden Sie das New-SPUserLicenseMapping Cmdlet, um ein neues Lizenzzuordnungsobjekt zu erstellen. Dieses Cmdlet muss zuerst verwendet werden, bevor das Add-SPUserLicenseMapping Cmdlet verwendet werden kann.

Das mithilfe des New-SPUserLicenseMapping Cmdlets erstellte Objekt wird im Arbeitsspeicher gespeichert und nicht in eine Datenbank in SharePoint Server geschrieben. Nachdem das Objekt erstellt wurde, können Sie das Ergebnis an das Add-SPUserLicenseMapping Cmdlet weiters übertragen.

Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.

Beispiele

----------------------- BEISPIEL---------------------------)

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

In diesem Beispiel wird ein Lizenzzuordnungsobjekt für die durch Active Directory gesicherte Gruppe namens "EntSecGroup" erstellt und anschließend das Ergebnis an das Add-SPUserLicenseMapping Cmdlet weitergeleitet.

Parameter

-Anspruch

Gibt den zu lizenzierenden Forderungsprinzipal an. Der Wert muss ein gültiger Forderungsprinzipal sein.

Type:SPClaim
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ClaimType

Gibt den Forderungstyp an. Der Wert muss ein gültiger Name eines Forderungstyps sein.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Fordert Sie zum Bestätigen auf, bevor der Befehl ausgeführt wird. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Lizenz

Gibt den Namen einer unterstützten SharePoint-Benutzerlizenz an. Eine vollständige Liste der unterstützten Lizenzen in einer SharePoint-Farm finden Sie im Get-SPUserLicense Cmdlet.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-OriginalIssuer

Gibt den ursprünglichen Forderungsaussteller an. Der Wert muss ein gültiger Name eines ursprünglichen Ausstellers sein.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-RoleProviderName

Gibt den Namen eines Rollenanbieters an. Der Wert muss ein gültiger Name eines Rollenanbieters sein.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Rolle

Gibt den Namen einer formularbasierten Rolle an. Der Wert muss ein gültiger Name einer formularbasierten Rolle sein.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SecurityGroup

Gibt den Namen einer AD DS-Sicherheitsgruppe an (Active Directory Domain Services, Active Directory-Domänendienste). Der Wert muss ein gültiger Name einer Active Directory-Sicherheitsgruppe sein.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ValueType

Gibt den Werttyp für die Forderung an. Der Wert muss ein gültiger Name eines Forderungswerttyps sein.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WebApplication

Specifies the URL, GUID, web application name, or web application object instance where the mapping is to be added. If you omit this parameter, the mapping is applied to the entire farm.

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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Wert

Gibt den Wert der Forderung an. Der Wert muss ein gültiger Forderungswert sein.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition