New-SPUserLicenseMapping
Crea un oggetto mapping delle licenze.
Sintassi
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>] Descrizione
Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.
Usare il New-SPUserLicenseMapping cmdlet per creare un nuovo oggetto di mapping delle licenze.
Questo cmdlet deve essere usato per primo prima di poter usare il Add-SPUserLicenseMapping cmdlet.
L'oggetto creato usando il New-SPUserLicenseMapping cmdlet viene archiviato in memoria e non viene scritto in alcun database in SharePoint Server.
Dopo aver creato l'oggetto, è possibile inviare il risultato tramite pipe al Add-SPUserLicenseMapping cmdlet.
Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.
Esempio
----------------------- ESEMPIO---------------------------)
$a = New-SPUserLicenseMapping -SecurityGroup EntSecGroup -License Enterprise
$a | Add-SPUserLicenseMappingIn questo esempio viene creato un oggetto di mapping delle licenze per il gruppo protetto di Active Directory denominato "EntSecGroup" e quindi viene eseguito il pipe del risultato al Add-SPUserLicenseMapping cmdlet.
Parametri
-AssignmentCollection
Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.
Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale.
Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.
| 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
Specifica l'entità attestazioni per cui fornire la licenza. Il valore deve essere un'entità attestazioni autentica.
| 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
Specifica il tipo dell'attestazione. Il valore deve essere un nome autentico di tipo di attestazione.
| 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
Richiede la conferma prima di eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: 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
Specifica il nome di una licenza utente di SharePoint supportata.
Per l'elenco completo delle licenze supportate in una farm di SharePoint, vedere il 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
Specifica l'autorità emittente originale dell'attestazione. Il valore deve essere il nome autentico di un'autorità emittente originale.
| 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
Specifica il nome di un ruolo basato su moduli. Il valore deve essere un nome autentico di un ruolo basato su moduli.
| 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
Specifica il nome di un provider di ruoli. Il valore deve essere un nome autentico di un provider di ruoli.
| 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
Specifica il nome di un gruppo di sicurezza di Servizi di dominio Active Directory. Il valore deve essere un nome di un gruppo di sicurezza di 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
Specifica il valore dell'attestazione. Il valore deve essere un valore di attestazione autentico.
| 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
Specifica il tipo di valore dell'attestazione. Il valore deve essere un nome autentico di un tipo di valore di attestazione.
| 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
Specifica l'URL, il GUID, il nome dell'applicazione Web o l'istanza dell'oggetto applicazione Web in cui deve essere aggiunto il mapping. Se si omette questo parametro, il mapping verrà applicato all'intera farm.
Il tipo deve essere un URL nel formato http://server_name o http://server_name/sites/sitename, un GUID, ad esempio 12345678-90ab-cdef-1234-567890bcdefgh, un nome di un'applicazione Web, ad esempio SharePoint - 80, o un'istanza di un oggetto applicazione 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
Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: 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 |