다음을 통해 공유


Add-SPDistributedCacheServiceInstance

배포된 캐시 서비스 인스턴스를 로컬 서버에 추가합니다.

Syntax

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

Description

이 cmdlet에는 둘 이상의 매개 변수 집합이 포함됩니다. 한 매개 변수 집합의 매개 변수만 사용할 수 있으며 서로 다른 매개 변수 집합의 매개 변수를 결합하면 안 됩니다. 매개 변수 집합을 사용하는 방법에 관한 자세한 내용은 Cmdlet 매개 변수 집합을 참조하세요.

Add-SPDistributedCacheServiceInstance cmdlet을 사용하여 분산 캐시 서버의 인스턴스를 로컬 서버에 추가합니다. 이렇게 해야 AppFabric 서비스를 시작할 수 있습니다.

예제

예 1

Add-SPDistributedCacheServiceInstance

이 예제에서는 배포된 캐시 서비스 인스턴스를 로컬 서버에 추가합니다.

매개 변수

-AssignmentCollection

올바른 삭제를 위해 개체를 관리합니다. SPWeb 또는 SPSite와 같은 개체를 사용하는 경우 많은 양의 메모리를 사용할 수 있으며, Windows PowerShell 스크립트에서 이러한 개체를 사용하려면 올바른 메모리 관리가 필요합니다. SPAssignment 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다.

참고: Global 매개 변수를 사용하면 모든 개체가 전역 저장소에 포함됩니다. 개체가 즉시 사용되지 않거나 Stop-SPAssignment 명령을 사용하여 삭제되지 않는 경우 메모리 부족 시나리오가 발생할 수 있습니다.

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

분산 캐시 서비스 인스턴스에 할당할 RAM의 크기를 지정합니다.

이 매개 변수를 지정하지 않을 경우 기본값이 사용됩니다.

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

분산 캐시 서비스 인스턴스를 구성해야 하는 서버 역할의 유형을 지정합니다.

이 매개 변수는 지정된 서버 역할로 서버 역할을 변환하려는 경우에 주로 사용됩니다.

유효한 값은 다음과 같습니다.

  • 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

입력

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

출력

System.Object