Add-SPDistributedCacheServiceInstance

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Aggiunge un'istanza del servizio cache distribuita a un server locale.

Sintassi

Add-SPDistributedCacheServiceInstance
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]
Add-SPDistributedCacheServiceInstance
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CacheSizeInMB <Int32>]
   [<CommonParameters>]
Add-SPDistributedCacheServiceInstance
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Role <SPServerRole>]
   [<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.

Utilizzare il cmdlet Add-SPDistributedCacheServiceInstance per aggiungere un'istanza del server della cache distribuita a un server locale. Questa operazione è necessaria per avviare il servizio AppFabric.

Esempio

Esempio 1

Add-SPDistributedCacheServiceInstance

In questo esempio viene aggiunta un'istanza del servizio della cache distribuita a un server locale.

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.

NOTA: quando si usa il parametro Global, tutti gli oggetti sono contenuti nell'archivio 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

-CacheSizeInMB

Specifica la quantità di RAM da allocare per l'istanza del servizio Cache distribuita.

Se questo parametro non è specificato, verrà usato il valore predefinito.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Role

Specifica il tipo di ruolo del server per cui deve essere configurata l'istanza del servizio Cache distribuita.

Questo parametro viene in genere usato quando si esegue una conversione del ruolo del server nel ruolo del server specificato.

I valori validi sono:

  • SingleServerFarm
  • DistributedCache
  • WebFrontEndWithDistributedCache
Type:SPServerRole
Accepted values:DistributedCache, SingleServerFarm, WebFrontEndWithDistributedCache
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

Input

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Output

System.Object