New-SPUserLicenseMapping

  • Referenz
Modul:
sharepoint-server
Gilt für::
SharePoint Server Subscription Edition

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

Dieses Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Parametersätze für Cmdlets.

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 mit dem New-SPUserLicenseMapping Cmdlet 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 übergeben.

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 geschützte Active Directory-Gruppe mit dem Namen "EntSecGroup" erstellt und das Ergebnis dann an das Add-SPUserLicenseMapping Cmdlet weitergeleitet.

Parameter

-AssignmentCollection

Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

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

-Claim

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

Type:SPClaim
Position:Named
Default value:None
Required:True
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
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-License

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

Type:String
Position:Named
Default value:None
Required:True
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
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Role

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

-Value

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WebApplication

Gibt die URL, die GUID, den Namen der Webanwendung oder die Webanwendungsobjektinstanz an, in der die Zuordnung hinzugefügt werden soll. Wenn Sie diesen Parameter weglassen, wird die Zuordnung auf die gesamte Farm angewendet.

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 Subscription Edition

-WhatIf

Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen. Um weitere Informationen zu erhalten, geben Sie den folgenden Befehl ein: 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 Subscription Edition