Freigeben über


Add-SPDistributedCacheServiceInstance

Fügt einem lokalen Server eine Instanz des verteilten Cachediensts hinzu.

Syntax

Add-SPDistributedCacheServiceInstance
   [-AssignmentCollection <SPAssignmentCollection>]
   [<CommonParameters>]
Add-SPDistributedCacheServiceInstance
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CacheSizeInMB <Int32>]
   [<CommonParameters>]
Add-SPDistributedCacheServiceInstance
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Role <SPServerRole>]
   [<CommonParameters>]

Beschreibung

Das 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 Cmdlet Add-SPDistributedCacheServiceInstance, um einem lokalen Server eine Instanz des verteilten Cachediensts hinzuzufügen. Dies ist zum Starten des AppFabric-Diensts erforderlich.

Beispiele

Beispiel 1

Add-SPDistributedCacheServiceInstance

In diesem Beispiel wird einem lokalen Server eine Instanz des verteilten Cachediensts hinzugefügt.

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.

HINWEIS: Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. 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
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-CacheSizeInMB

Gibt die Größe des Arbeitsspeichers an, die der Instanz des verteilten Cachediensts zugewiesen wird.

Wenn dieser Parameter nicht angegeben ist, wird der Standardwert verwendet.

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

Gibt den Typ der Serverrolle an, für die die Instanz des verteilten Cachediensts konfiguriert werden sollte.

Dieser Parameter wird in der Regel bei der Konvertierung einer Serverrolle in die angegebene Serverrolle verwendet.

Die gültigen Werte lauten:

  • 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

Eingaben

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Ausgaben

System.Object