Поделиться через


Add-SPDistributedCacheServiceInstance

Добавляет на локальный сервер экземпляр службы распределенного кэша.

Синтаксис

Default

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

CacheSizeSet

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

LocalServerRoleSet

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

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров; использование параметров из разных наборов не допускается. Для получения дополнительной информации об использовании наборов параметров см. Наборы параметров командлета.

Командлет Add-SPDistributedCacheServiceInstance используется для добавления на сервер экземпляра службы распределенного кэша. Это необходимо для запуска службы AppFabric.

Примеры

Пример 1

Add-SPDistributedCacheServiceInstance

В этом примере показано добавление на локальный сервер экземпляра службы распределенного кэша.

Параметры

-AssignmentCollection

Применимо: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

ПРИМЕЧАНИЕ. При использовании параметра Global все объекты содержатся в глобальном хранилище. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Свойства параметра

Тип:SPAssignmentCollection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CacheSizeInMB

Применимо: SharePoint Server 2016, SharePoint Server 2019

Указывает объем памяти ОЗУ, который нужно выделить для экземпляра службы распределенного кэша.

Если этот параметр не указан, используется значение по умолчанию.

Свойства параметра

Тип:Int32
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

CacheSizeSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Role

Применимо: SharePoint Server 2016, SharePoint Server 2019

Указывает тип роли сервера, для которой нужно настроить экземпляр службы распределенного кэша. Этот параметр обычно используется, когда вы планируете преобразовать роль сервера.

Допустимые значения:

  • SingleServerFarm
  • DistributedCache
  • WebFrontEndWithDistributedCache

Свойства параметра

Тип:SPServerRole
Default value:None
Допустимые значения:DistributedCache, SingleServerFarm, WebFrontEndWithDistributedCache
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

LocalServerRoleSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

Входные данные

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Выходные данные

System.Object