Get-CsDeviceUpdateRule
마지막으로 수정된 항목: 2012-03-23
조직에서 사용하도록 구성된 장치 업데이트 규칙에 대한 정보를 반환합니다. 장치 업데이트 규칙은 펌웨어 업데이트를 Microsoft Lync 2010 Phone Edition을 실행하는 장치와 연결하는 데 사용됩니다.
구문
Get-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDeviceUpdateRule [-Filter <String>] [-LocalStore <SwitchParameter>]
자세한 정보
Microsoft Lync Server 2010에서는 Lync 2010 Phone Edition을 실행하는 장치에 펌웨어 업데이트를 제공하는 한 가지 방법으로 장치 업데이트 규칙을 사용합니다. 관리자는 장치 업데이트 규칙 집합을 주기적으로 Lync Server 2010에 업로드합니다. 그러면 이러한 규칙이 테스트 및 승인된 후 시스템에 연결된 적절한 장치에 자동으로 다운로드되어 적용됩니다. 장치는 기본적으로 장치를 켜고 Lync Server에 연결할 때마다 새 업데이트 규칙을 확인합니다. 또한 초기 로그온 후 24시간 간격으로 업데이트를 확인합니다.
장치 업데이트 규칙은 웹 서비스 서비스에 가져와 적용할 수 있습니다. Get-CsDeviceUpdateRule cmdlet은 사용자의 조직에서 사용하기 위해 가져온 장치 업데이트 규칙에 대한 정보를 반환합니다.
이 cmdlet을 실행할 수 있는 사용자: 기본적으로 RTCUniversalUserAdmins 및 RTCUniversalServerAdmins 그룹의 구성원은 Get-CsDeviceUpdateRule cmdlet을 로컬로 실행할 수 있습니다. 사용자가 직접 만든 사용자 지정 RBAC(역할 기반 액세스 제어) 역할을 포함하여 이 cmdlet이 할당된 모든 RBAC 역할의 목록을 가져오려면 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsDeviceUpdateRule"}
매개 변수
| 매개 변수 | 필수 | 유형 | 설명 |
|---|---|---|---|
Identity |
선택 |
Xds ID |
장치 업데이트 규칙에 대한 고유한 식별자입니다. 장치 업데이트 규칙 ID는 규칙이 적용된 서비스 범위(예: service:WebServer:atl-cs-001.litwareinc.com) 및 규칙에 미리 할당된 GUID(Globally Unique Identification)(예: d5ce3c10-2588-420a-82ac-dc2d9b1222ff9)의 두 부분으로 구성됩니다. 이를 기반으로, 지정된 장치 업데이트 규칙 ID는 "service:WebServer:atl-cs-001.litwareinc.com /d5ce3c10-2588-420a-82ac-dc2d9b1222ff9"와 유사합니다. ID를 지정할 때는 와일드카드를 사용할 수 없습니다. 규칙을 지정할 때 와일드카드를 사용하려면 Filter 매개 변수를 사용합니다. |
Filter |
선택 |
문자열 |
장치 업데이트 규칙이나 규칙 집합의 ID를 지정할 때 와일드 카드를 활용하는 데 사용됩니다. 예를 들어 WebServer:atl-cs-001.litwareinc.com에 대한 모든 장치 업데이트 규칙을 반환하려면 필터 값으로 "service:WebServer:atl-cs-001.litwareinc.com*"을 사용합니다. |
LocalStore |
선택 |
스위치 매개 변수 |
중앙 관리 저장소 자체가 아니라 중앙 관리 저장소의 로컬 복제본에서 장치 업데이트 규칙 데이터를 검색합니다. |
입력 형식
없음. Get-CsDeviceUpdateRule은 파이프라인된 입력을 허용하지 않습니다.
반환 형식
Get-CsDeviceUpdateRule은 Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule 개체의 인스턴스를 반환합니다.
예제
-------------------------- 예제 1 --------------------------
Get-CsDeviceUpdateRule
위 명령은 사용자의 조직에 적용된 모든 장치 업데이트 규칙에 대한 정보를 반환합니다. Get-CsDeviceUpdateRule을 추가 매개 변수 없이 호출하면 항상 장치 업데이트 규칙의 전체 컬렉션이 반환됩니다.
-------------------------- 예제 2 --------------------------
Get-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9
예제 2에 표시된 명령은 ID가 "WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9"인 장치 업데이트 규칙에 대한 정보를 반환합니다.
-------------------------- 예제 3 --------------------------
Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com*
예제 3에서는 WebServer:atl-cs-001.litwareinc.com 서비스에 대해 구성된 모든 장치 업데이트 규칙에 대한 정보를 반환합니다. 이 작업을 수행하기 위해 Filter 매개 변수가 필터 값 "WebServer:atl-cs-001.litwareinc.com *"과 함께 사용됩니다. 이 필터는 ID가 문자열 값 "service:WebServer:atl-cs-001.litwareinc.com"으로 시작하는 장치 업데이트 규칙에 대한 데이터만 반환하도록 제한합니다.
-------------------------- 예제 4 --------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"}
위 명령은 Brand 속성이 "LG-Nortel"과 같은 모든 장치 업데이트 규칙을 반환합니다. 이 작업을 수행하기 위해 Get-CsDeviceUpdateRule을 호출하여 조직의 모든 장치 업데이트 규칙 컬렉션을 반환합니다. 이 컬렉션은 Brand가 "LG-Nortel"과 같은 규칙만 선택하는 Where-Object에 파이프됩니다.
-------------------------- 예제 5 ------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -eq $Null}
예제 5에서는 승인되지 않은 모든 장치 업데이트 규칙의 컬렉션을 반환합니다. 이 작업을 수행하기 위해 Get-CsDeviceUpdateRules를 사용하여 모든 규칙의 컬렉션을 반환하고 이 컬렉션을 Where-Object에 파이프합니다. 그리고 Where-Object는 Approved 속성이 null 값과 같은 규칙만 선택합니다. Approved 속성이 null인 경우 이러한 규칙이 승인되지 않았음을 의미합니다.
-------------------------- 예제 6 --------------------------
Get-CsDeviceUpdateRule | Where-Object {$_.ApprovedVersion -ne $Null -and $_.Brand -eq "LG-Nortel"}
위에 표시된 명령은 승인되고 LG-Nortel 장치와 관련 있는 규칙이어야 한다는 두 가지 기준을 충족하는 모든 장치 업데이트 규칙의 컬렉션을 반환합니다. 이 작업을 수행하기 위해 먼저 Get-CsDeviceUpdateRule을 호출하여 조직의 모든 장치 업데이트 규칙 컬렉션을 반환합니다. 이 컬렉션은 Approved 속성이 null이 아니고(즉, 이 속성에 값이 있어야 함), Brand가 "LG-Nortel"과 같아야 한다는 두 조건에 대해 컬렉션을 필터링하는 Where-Object에 파이프됩니다.