Stop-CsWindowsService

 

마지막으로 수정된 항목: 2012-03-27

Stop-CsWindowsService를 사용하여 Microsoft Lync Server 2010 서비스를 중지할 수 있습니다.

구문

Stop-CsWindowsService [-Name <String>] [-ComputerName <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Graceful <SwitchParameter>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

Stop-CsWindowsService [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Graceful <SwitchParameter>] [-InputObject <NTService>] [-NoWait <SwitchParameter>] [-Report <String>] [-WhatIf [<SwitchParameter>]]

자세한 정보

많은 Lync Server 2010 구성 요소가 표준 Windows 서비스로 실행됩니다. 예를 들어 회의 길잡이 응용 프로그램은 실제로 RTCCAA라는 서비스입니다. Lync Server를 중지하려면 Stop-CsWindowsService cmdlet을 사용하면 됩니다.

Stop-CsWindowsService는 Lync Server 서비스만 중지할 수 있습니다. 이 cmdlet을 사용하여 Lync Server 이외의 서비스(예: 인쇄 스풀러)를 중지하려고 하면 오류가 발생합니다.

기능 면에서 Stop-CsWindowsService는 일반적인 Windows PowerShell cmdlet Stop-Service와 상당히 비슷합니다. 원하는 경우 Stop-Service를 사용하여 Lync Server 서비스를 중지할 수 있습니다. 그러나 Stop-CsWindowsService에는 원격 컴퓨터의 서비스를 쉽게 중지할 수 있는 ComputerName 매개 변수가 포함되어 있습니다. ComputerName 매개 변수를 넣고 그 뒤에 원격 컴퓨터의 FQDN(정규화된 도메인 이름)을 입력하기만 하면 됩니다. Stop-Service cmdlet에는 비교 가능한 매개 변수가 없습니다. 또한 Stop-CsWindowsService에는 Stop-CsWindowsService를 호출할 때 발생할 수 있는 모든 오류를 기록하는 데 사용되는 Report 매개 변수가 있습니다.

Stop-CsWindowsService는 이름으로 알 수 있듯이 사용자가 중지하도록 요청한 모든 서비스를 중지합니다. 여기에는 사용자가 중지하려는 서비스가 실행 중인 경우에만 실행할 수 있는 서비스인 종속 서비스가 포함됩니다. 기본적으로 종속 서비스가 있는 서비스를 중지하려고 하면 Stop-CsWindowsService가 해당 서비스뿐만 아니라 모든 종속 서비스까지도 중지하게 됩니다. 이는 예기치 않은 결과를 가져올 수 있으므로 Stop-CsWindowsService를 호출할 때는 Graceful 매개 변수를 포함해야 합니다. Graceful 매개 변수를 포함하면 Stop-CsWindowsService가 새 요청 수신 서비스를 차단합니다. 기존 서비스 요청은 모두 그대로 유지되고, 새 요청만 거부됩니다. 기존 요청이 완료되면 이러한 요청이 대체되지 않습니다. 결국 기존 요청이 모두 채워진 다음 서비스가 종료됩니다.

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

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

매개 변수

Parameter 필수 유형 설명

Name

선택

문자열

중지하려는 Lync Server 서비스의 이름입니다. 서비스 표시 이름이 아니라 서비스 이름(예: RTCCAA)을 사용해야 합니다. Name 매개 변수에는 단일 서비스 이름만 전달할 수 있으며 서비스 이름에는 와일드카드를 사용할 수 없습니다. Get-CsWindowsService cmdlet을 사용하여 서비스 이름을 검색할 수 있습니다.

Stop-CsWindowsService는 Lync Server 서비스만 중지할 수 있으므로 이 cmdlet을 사용하여 다른 Windows 서비스를 중지할 수 없습니다. 이러한 서비스의 경우 Windows PowerShell Stop-Service cmdlet을 사용할 수 있습니다.

ComputerName

선택

문자열

중지할 서비스를 실행 중인 원격 컴퓨터의 이름입니다. 이 매개 변수가 포함되지 않은 경우 Stop-CsWindowsService가 로컬 컴퓨터의 지정된 서비스를 중지하게 됩니다. 원격 컴퓨터는 FQDN(예: atl-mcs-001.litwareinc.com)을 사용하여 참조해야 합니다.

Graceful

선택

스위치 매개 변수

서비스를 즉시 종료하지 않고 기존 서비스 요청이 모두 채워질 때까지 기다립니다. 그러나 새 서비스 요청은 모두 거부됩니다. 기존 요청이 모두 채워져야 서비스가 완전히 종료됩니다.

InputObject

선택

NT 서비스 개체

서비스 이름이 아닌 개체 참조를 사용하여 서비스를 중지할 수 있습니다. 예를 들어 Get-CsWindowsService를 사용하여 서비스에 대한 정보를 반환하는 경우 및 반환된 개체를 $x라는 변수에 저장하는 경우

$x = Get-CsWindowsService –Name "RTCCPS"

Stop-CsWindowsService -InputObject $x.Name 명령을 사용하여 서비스를 중지할 수 있습니다.

NoWait

선택

스위치 매개 변수

있는 경우 명령이 실행된 다음 즉시 Windows PowerShell 프롬프트로 제어가 반환됩니다. 없는 경우 명령이 완료되고 상태 보고서가 화면에 기록될 때까지 제어권이 반환되지 않습니다.

Force

선택

스위치 매개 변수

명령을 실행할 때 발생할 수 있는 심각하지 않은 오류 메시지를 표시하지 않습니다.

Report

선택

문자열

오류 정보를 기록할 수 있는 HTML 파일의 경로입니다. 이 매개 변수가 포함된 경우 이 cmdlet 실행 중에 발생하는 모든 오류는 지정된 파일(예: C:\Logs\Service_report.html)에 기록됩니다.

WhatIf

선택

스위치 매개 변수

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

Confirm

선택

스위치 매개 변수

명령을 실행하기 전에 확인 메시지를 표시합니다.

입력 형식

Microsoft.Rtc.Management.Deployment.Core.NTService 개체입니다. Stop-CsWindowsService는 Windows 서비스 개체의 파이프라인된 인스턴스를 허용합니다.

반환 형식

없음. 대신 Stop-CsWindowsService는 Microsoft.Rtc.Management.Deployment.Core.NTService 개체의 인스턴스를 중지합니다.

예제

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

Stop-CsWindowsService -Name "RTCRGS"

예제 1에 표시된 명령은 로컬 컴퓨터의 응답 그룹 응용 프로그램 서비스를 중지합니다. 응답 그룹 응용 프로그램 서비스는 Name 매개 변수 및 해당 서비스 이름 RTCRGS를 포함하여 식별됩니다.

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

Stop-CsWindowsService -Name "RTCRGS" -ComputerName atl-cs-001.litwareinc.com

예제 2도 응답 그룹 응용 프로그램 서비스를 중지합니다. 그러나 이 예제에서는 해당 서비스가 원격 컴퓨터 atl-cs-001.litwareinc.com에 있습니다. 원격 컴퓨터의 서비스를 중지하려면 ComputerName 매개 변수 뒤에 원격 컴퓨터의 FQDN을 포함합니다.

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

Get-CsWindowsService | Where-Object {$_.DisplayName -like "*Call Park*"} | Stop-CsWindowsService

예제 3은 서비스 이름(이 경우 RTCCPS)을 모르는 경우에도 서비스를 중지할 수 있는 방법을 보여 줍니다. 이 작업을 수행하기 위해 먼저 Get-CsWindowsService를 매개 변수 없이 호출하여 로컬 컴퓨터에 있는 모든 Lync Server 서비스의 컬렉션을 반환합니다. 그런 다음 이 컬렉션 전체가 DisplayName 속성에 "Call Park" 문자열이 포함된 서비스만 선택하는 Where-Object cmdlet에 파이프됩니다. 그리고 필터링된 컬렉션이 통화 대기 응용 프로그램 서비스를 중지하는 Stop-CsWindowsService에 파이프됩니다.

참고 항목

기타 리소스

Get-CsWindowsService
Start-CsWindowsService