Set-CsDiagnosticConfiguration

구문

Set-CsDiagnosticConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsDiagnosticConfiguration [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Filter <Filter>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

자세한 정보

Lync Server 2010에 대해 로깅을 사용하도록 설정하면 기본적으로 모든 도메인 또는 URI에서 들어오거나 나가는 트래픽이 이러한 로그 파일에 포함됩니다. 이렇게 하면 로그 파일에 가능한 많은 정보가 기록됩니다.

그러나 너무 많은 정보가 기록되는 경우도 있습니다. 예를 들어 특정 도메인과 연결하는 데 문제가 있는 경우 사용자 네트워크와 해당 도메인 간의 트래픽 로깅을 제한하는 것이 좋습니다. 이렇게 하면 관련 기록을 쉽게 식별할 수 있으므로 문제를 더 쉽게 진단하고 해결할 수 있습니다.

진단 구성 설정을 사용하면 로그 파일에 기록되는 도메인 또는 URI를 지정할 수 있습니다. Lync Server를 사용하여 사이트 범위에서 진단 구성 설정을 만들 수 있습니다. 따라서 다른 사이트에 적용한 것과 다른 설정을 Redmond 사이트에 적용할 수 있습니다.

Set-CsDiagnosticConfiguration cmdlet을 사용하여 지정된 컬렉션에서 필터를 추가하거나 제거할 수도 있습니다. 필터는 트래픽을 기록해야 하는 도메인을 표시하는 데 사용됩니다.

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

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

매개 변수

입력 형식

Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings 개체입니다. Set-CsDiagnosticConfiguration은 진단 구성 설정 개체의 파이프라인된 인스턴스를 허용합니다.

반환 형식

Set-CsDiagnosticConfiguration은 값이나 개체를 반환하지 않습니다. 대신 이 cmdlet은 Microsoft.Rtc.Management.WritableConfig.Settings.Diagnostics.DiagnosticFilterSettings 개체의 인스턴스를 구성합니다.

예제

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

$x = New-CsDiagnosticsFilter -Fqdn fabrikam.com -Uri sip:user@fabrikam.com 
Set-CsDiagnosticConfiguration -Identity global -Filter $x

예제 1에 표시된 명령은 New-CsDiagnosticsFilter를 사용하여 새 진단 필터를 만든 다음 해당 필터를 전역 진단 구성 설정에 할당합니다. 이 작업을 수행하기 위해 첫 번째 명령은 New-CsDiagnosticsFilter를 호출하여 메모리에만 나타나는 진단 필터를 만듭니다. 이 필터는 FQDN fabrikam.com과 URI sip:user@fabrikam.com을 사용합니다. 그런 다음 "가상" 필터는 변수 $x에 저장됩니다.

명령 2에서는 Set-CsDiagnosticConfiguration을 사용하여 글로벌 진단 구성 설정에 새 필터를 할당합니다. 이 경우 Filter 속성의 기존 값이 새로 만든 필터로 대체됩니다.

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

$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Add("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x

예제 2에서는 전역 진단 구성 설정의 Filter 속성에 새 FQDN을 추가하는 방법을 보여 줍니다. 이 작업을 수행하기 위해 예제의 첫 번째 명령은 Get-CsDiagnosticConfiguration을 사용하여 전역 설정에 대한 Filter 속성 값을 검색합니다. 이를 위해 Get-CsDiagnosticConfiguration에 대한 호출을 괄호로 묶습니다. 그러면 Windows PowerShell이 해당 명령을 우선적으로 실행합니다. 전역 설정이 반환된 후 Filter 속성 값이 추출되고 변수 $x에 저장됩니다.

두 번째 명령에서는 Add 메서드를 사용하여 새 FQDN(fabrikam.com)을 필터에 추가합니다. 이 작업이 완료되면 예제의 마지막 명령이 Set-CsDiagnosticConfiguration을 사용하여 수정된 진단 모음을 기록합니다. 최종적으로 fabrikam.com이 이미 Filter 속성에 포함된 FQDN에 추가됩니다.

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

$x = (Get-CsDiagnosticConfiguration -Identity global).Filter
$x.Fqdn.Remove("fabrikam.com")
Set-CsDiagnosticConfiguration -Identity global -Filter $x

예제 3에 표시된 명령은 FQDN(fabrikam.com)을 Filter 속성 글로벌 진단 필터 구성 설정에서 제거합니다. 예제의 첫 번째 명령은 Get-CsDiagnosticConfiguration을 사용하여 글로벌 설정에 대한 Filter 속성의 현재 값을 검색합니다. 이 값은 변수 $x에 저장됩니다. 값이 검색된 후 Remove 메서드를 사용하여 FQDN fabrikam.com을 제거합니다. FQDN이 제거된 후 Set-CsDiagnosticConfiguration을 사용하여 $x에 저장된 수정된 필터를 글로벌 설정에 기록합니다.

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

Set-CsDiagnosticConfiguration -Identity global -Filter $Null

예제 4에서는 글로벌 진단 구성 설정의 Filter 속성에서 모든 항목을 제거합니다. 이 작업을 수행하기 위해 Filter 속성을 null 값으로 설정합니다.

참고 항목

기타 리소스

Get-CsDiagnosticConfiguration
New-CsDiagnosticConfiguration
New-CsDiagnosticsFilter
Remove-CsDiagnosticConfiguration