Compartilhar via


Add-SPDistributedCacheServiceInstance

Adiciona uma instância do serviço de cache distribuído a um servidor local.

Sintaxe

Default

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

CacheSizeSet

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

LocalServerRoleSet

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

Description

Este cmdlet contém mais de um conjunto de parâmetros. Você só pode usar parâmetros de um único conjunto de parâmetros; além disso, não é possível combinar parâmetros de diferentes conjuntos. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de Parâmetros de Cmdlets.

Use o cmdlet Add-SPDistributedCacheServiceInstance para adicionar uma instância do servidor de cache distribuído a um servidor local. Isso é necessário para iniciar o serviço AppFabric.

Exemplos

Exemplo 1

Add-SPDistributedCacheServiceInstance

Este exemplo adiciona uma instância do serviço de cache distribuído a um servidor local.

Parâmetros

-AssignmentCollection

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

NOTA: quando o parâmetro Global é utilizado, todos os objetos estão contidos no arquivo global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CacheSizeInMB

Aplicável: SharePoint Server 2016, SharePoint Server 2019

Especifica a quantidade de RAM a alocar para a instância do serviço de Cache Distribuído.

Se esse parâmetro não estiver especificado, o valor local será usado.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

CacheSizeSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Role

Aplicável: SharePoint Server 2016, SharePoint Server 2019

Especifica o tipo de função de servidor para a qual a instância do serviço de Cache Distribuído deverá estar configurada. Este parâmetro normalmente é usado quando você vai fazer uma conversão da função de servidor para a função de servidor especificada.

Os valores válidos são:

  • SingleServerFarm
  • DistributedCache
  • WebFrontEndWithDistributedCache

Propriedades do parâmetro

Tipo:SPServerRole
Valor padrão:None
Valores aceitos:DistributedCache, SingleServerFarm, WebFrontEndWithDistributedCache
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

LocalServerRoleSet
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

Entradas

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Saídas

System.Object