Partager via


Add-SPDistributedCacheServiceInstance

Ajoute une instance du service de cache distribué sur un serveur local.

Syntaxe

Default

Add-SPDistributedCacheServiceInstance
    [-AssignmentCollection <SPAssignmentCollection>]
    [<CommonParameters>]

CacheSizeSet

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

LocalServerRoleSet

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

Description

Cette cmdlet contient plus d’un jeu de paramètres. Vous ne pouvez utiliser les paramètres que d'un seul jeu et vous ne pouvez pas combiner les paramètres de différents jeux. Pour plus d’informations sur l’utilisation des jeux de paramètres, consultez les Jeux de paramètres des applets de commande.

Utilisez l’applet de commande Add-SPDistributedCacheServiceInstance pour ajouter une instance du serveur de cache distribué sur un serveur local. Ceci est obligatoire pour démarrer le service AppFabric.

Exemples

Exemple 1

Add-SPDistributedCacheServiceInstance

Cet exemple ajoute une instance du service de cache distribué sur un serveur local.

Paramètres

-AssignmentCollection

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d'attributions ou le paramètre Global ne sont pas utilisés.

REMARQUE : Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Propriétés du paramètre

Type:SPAssignmentCollection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-CacheSizeInMB

Applicable : SharePoint Server 2016, SharePoint Server 2019

Indique la quantité de RAM à allouer pour l’instance de service de cache distribué.

Si ce paramètre n'est pas spécifié, la valeur par défaut sera utilisée.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

CacheSizeSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Role

Applicable : SharePoint Server 2016, SharePoint Server 2019

Spécifie le type de rôle serveur pour lequel l’instance de service de cache distribué doit être configurée. Ce paramètre est généralement utilisé lorsque vous vous apprêtez à réaliser une conversion de rôle serveur sur le rôle serveur spécifié.

Les valeurs valides sont les suivantes :

  • SingleServerFarm
  • DistributedCache
  • WebFrontEndWithDistributedCache

Propriétés du paramètre

Type:SPServerRole
Valeur par défaut:None
Valeurs acceptées:DistributedCache, SingleServerFarm, WebFrontEndWithDistributedCache
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

LocalServerRoleSet
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Sorties

System.Object