Add-SPDistributedCacheServiceInstance
Fügt einem lokalen Server eine Instanz des verteilten Cachediensts hinzu.
Syntax
Default
Add-SPDistributedCacheServiceInstance
[-AssignmentCollection <SPAssignmentCollection>]
[<CommonParameters>]
CacheSizeSet
Add-SPDistributedCacheServiceInstance
[-AssignmentCollection <SPAssignmentCollection>]
[-CacheSizeInMB <Int32>]
[<CommonParameters>]
LocalServerRoleSet
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
Anwendbar: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | SPAssignmentCollection |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CacheSizeInMB
Anwendbar: SharePoint Server 2016, SharePoint Server 2019
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.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
CacheSizeSet
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Role
Anwendbar: SharePoint Server 2016, SharePoint Server 2019
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
Parametereigenschaften
| Typ: | SPServerRole |
| Standardwert: | None |
| Zulässige Werte: | DistributedCache, SingleServerFarm, WebFrontEndWithDistributedCache |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
LocalServerRoleSet
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.