Get-CsService

구문

Get-CsService [-Identity <XdsGlobalRelativeIdentity>] [-PoolFqdn <String>]

Get-CsService [-ApplicationServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-ApplicationDatabase <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-ArchivingServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-ArchivingDatabase <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-CentralManagement <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-CentralManagementDatabase <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-ConferencingServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-Director <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-EdgeServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-PoolFqdn <String>] [-TrustedApplicationPool <SwitchParameter>]

Get-CsService [-FileStore <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-ManagementServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-MediationServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-MonitoringServer <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-MonitoringDatabase <SwitchParameter>] [-PoolFqdn <String>]

Get-CsService [-PoolFqdn <String>] [-PstnGateway <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-ProvisionServer <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-ProvisionDatabase <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-Registrar <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-UserServer <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-UserDatabase <SwitchParameter>]

Get-CsService [-PoolFqdn <String>] [-WebServer <SwitchParameter>]

Get-CsService [-Filter <String>] [-PoolFqdn <String>]

자세한 정보

Lync Server 2010의 기능은 일반적으로 서비스 또는 서버 역할로 표시됩니다. 예를 들어 조직에서 발생하는 모든 인스턴트 메시징 세션의 대화 내용을 자동으로 저장하도록 Lync Server를 구성할 수 있습니다. 이렇게 구성하려면 보관 서버 서버 역할을 설치해야 합니다. 서비스 및 서버 역할은 Lync Server를 설치할 때 함께 구성하거나 소프트웨어를 실행한 후에 구성할 수 있습니다.

Get-CsService cmdlet을 사용하면 조직에서 실행 중인 서버 역할 및 서비스에 대한 정보를 반환하는 데 사용됩니다. Get-CsService를 추가 매개 변수 없이 호출하면 모든 서비스 및 서버 역할에 대한 세부 정보가 반환됩니다. 또는 -PoolFqdn 매개 변수를 사용하여 반환되는 데이터를 지정된 풀로 제한할 수 있습니다. 그리고 스위치 매개 변수를 원하는 만큼 사용하여 반환되는 데이터를 특정 유형의 서비스로 제한할 수 있습니다. 참고로, 스위치 매개 변수는 매개 변수 값이 필요 없는 매개 변수입니다. 예를 들어 Get-CsService -ArchivingServer 명령은 모든 보관 서버에 대한

정보를 반환합니다.

이러한 스위치 매개 변수는 각 명령에 하나만 사용할 수 있습니다. 보관 서버와 모니터링 서버 모두에 대한 정보를 반환하도록 하는

Get-CsService –ArchivingServer –MonitoringServer 명령은 실패합니다.

여러 서버 역할에 대한 정보를 반환해야 하는 경우 Get-CsService를 사용하여 서비스 데이터의 전체 컬렉션을 반환한 다음 해당 데이터를 Where-Object cmdlet에 파이프할 수 있습니다.

Get-CsService | Where-Object {$_.Role –eq "ArchivingServer" –or $_.Role –eq "MonitoringServer"}

이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins 및 RTCUniversalServerAdmins 그룹의 구성원은 Get-CsService cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsService"}

매개 변수

입력 형식

없음. Get-CsService는 파이프라인된 입력을 허용하지 않습니다.

반환 형식

Get-CsService는 cmdlet을 호출할 때 사용되는 매개 변수에 따라 다른 개체를 반환합니다. 예를 들어 MonitoringDatabase 매개 변수를 포함하면 Get-CsService는 Microsoft.Rtc.Management.Xds.DisplayMonitoringDatabase 개체의 인스턴스를 반환합니다. 다른 매개 변수를 사용할 경우 반환되는 개체를 확인하려면 다음 매개 변수 중 하나를 사용하여 Get-CsService를 호출한 다음 반환되는 개체를 Get-Member cmdlet에 파이프합니다(예: Get-CsService -Registrar | Get-Member).

예제

-------------------------- 예제 1 --------------------------

Get-CsService

예제 1에 표시된 명령은 조직에서 현재 실행 중인 모든 Lync Server 2010 서비스 및 서버 역할에 대한 정보를 반환합니다.

-------------------------- 예제 2 --------------------------

Get-CsService -ApplicationServer

예제 2는 응용 프로그램 서비스에 대한 정보만 반환합니다. 적절한 매개 변수를 사용하면 다른 서비스/서버 역할에 대한 정보를 반환할 수 있습니다. 예를 들어 Get-CsService -FileStore 명령은 파일 저장소에 대한 정보를

반환합니다.

-------------------------- 예제 3 --------------------------

Get-CsService -PoolFqdn "atl-cs-001.litwareinc.com" | Select-Object Identity

위의 명령은 atl-cs-001.litwareinc.com 풀에 있는 각 서비스의 ID를 다시 보고합니다. 이 작업을 수행하기 위해 명령은 먼저 Get-CsService 및 PoolFqdn 매개 변수를 호출하여 atl-cs-001.litwareinc.com 풀에 있는 해당 서비스 및 서버 역할만 반환합니다. 이 컬렉션은 컬렉션의 각 항목 ID를 다시 보고하는 Select-Object cmdlet에 파이프됩니다.

-------------------------- 예제 4 --------------------------

Get-CsService | Where-Object {$_.SiteID -eq "site:Redmond"}

예제 4에서는 Redmond 사이트에 있는 모든 서비스/서버 역할에 대해 정보가 반환됩니다. 이 작업을 수행하기 위해 먼저 매개 변수 없이 Get-CsService를 호출하여 조직에서 현재 사용 중인 모든 서비스 및 서버 역할의 컬렉션을 반환합니다. 이 데이터는 SiteID 속성이 site:Redmond와 같은 항목만 선택하는 Where-Object cmdlet에 파이프됩니다.

-------------------------- 예제 5 ------------------------

Get-CsService | Where-Object {$_.DependentServiceList -like "*Registrar*"}

예제 5에 표시된 명령은 등록자를 종속 서비스로 표시하는 모든 서비스에 대한 정보를 반환합니다. 이 작업을 수행하기 위해 Get-CsService를 호출하여 현재 사용 중인 모든 서비스 및 서버 역할의 컬렉션을 반환합니다. 이 컬렉션은 DependentServiceList 속성에 "Registrar"라는 문자열 값이 포함된 각 항목을 선택하는 Where-Object에 파이프됩니다. Where-Object 조건은 -like 연산자와 와일드카드 값 "*Registrar*"를 사용하여 지정합니다.

참고 항목

기타 리소스

Set-CsApplicationServer
Set-CsArchivingServer
Set-CsConferenceServer
Set-CsDirector
Set-CsEdgeServer
Set-CsManagementServer
Set-CsMediationServer
Set-CsMonitoringServer
Set-CsRegistrar
Set-CsUserServer
Set-CsWebServer