Set-DnsServerDiagnostics

업데이트 날짜: 2015년 5월

Set-DnsServerDiagnostics

Sets debugging and logging parameters.

구문

Parameter Set: Parameters
Set-DnsServerDiagnostics [-Answers <Boolean> ] [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-EnableLogFileRollover <Boolean> ] [-EnableLoggingForLocalLookupEvent <Boolean> ] [-EnableLoggingForPluginDllEvent <Boolean> ] [-EnableLoggingForRecursiveLookupEvent <Boolean> ] [-EnableLoggingForRemoteServerEvent <Boolean> ] [-EnableLoggingForServerStartStopEvent <Boolean> ] [-EnableLoggingForTombstoneEvent <Boolean> ] [-EnableLoggingForZoneDataWriteEvent <Boolean> ] [-EnableLoggingForZoneLoadingEvent <Boolean> ] [-EnableLoggingToFile <Boolean> ] [-EventLogLevel <UInt32> ] [-FullPackets <Boolean> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-IPFilterList <IPAddress[]> ] [-LogFilePath <String> ] [-MaxMBFileSize <UInt32> ] [-Notifications <Boolean> ] [-PassThru] [-Queries <Boolean> ] [-QuestionTransactions <Boolean> ] [-ReceivePackets <Boolean> ] [-SaveLogsToPersistentStorage <Boolean> ] [-SendPackets <Boolean> ] [-TcpPackets <Boolean> ] [-ThrottleLimit <Int32> ] [-UdpPackets <Boolean> ] [-UnmatchedResponse <Boolean> ] [-Updates <Boolean> ] [-UseSystemEventLog <Boolean> ] [-WriteThrough <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: All
Set-DnsServerDiagnostics -All <Boolean> [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: LogLevel
Set-DnsServerDiagnostics [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-DebugLogging <UInt32> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-OperationLogLevel1 <UInt32> ] [-OperationLogLevel2 <UInt32> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>] [ <WorkflowParameters>]




자세한 설명

The Set-DnsServerDiagnostics cmdlet sets debugging and logging parameters on a Domain Name System (DNS) server.

To enable debug logging, specify a value of $True for the FullPackets parameter and do the following:

-- Set the ReceivePackets parameter or the SendPackets parameter to $True.
-- Set the TcpPackets parameter or the UdpPackets parameter to $True.
-- Set the Notifications parameter, the Queries parameter, or the Updates parameter to $True.
-- Set the QuestionTransactions parameter or the Answers parameter to $True.

If you use the Parameters parameter set, you must specify at least one of the options in each of the following pairs of parameters:

-- ReceivePackets, SendPackets
-- TcpPackets, UdpPackets
-- Notifications, Updates, Queries
-- QuestionTransactions, Answers

The All parameter set enables all options except for the following: LogFilePath, MaxMBFileSize, EventLogLevel, FilterIpAddrList, UseSystemEventLog, and EnableLogFileRollover.

Use the LogLevel parameter to enable diagnostics at a more detailed level.

매개 변수

-All<Boolean>

Specifies whether the DNS server logs all events.


별칭

none

필수 여부

true

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-Answers<Boolean>

Specifies wheter to enable the logging of DNS responses.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-CimSession<CimSession[]>

원격 세션이나 원격 컴퓨터에서 cmdlet을 실행합니다. 컴퓨터 이름이나 New-CimSession 또는 Get-CimSession cmdlet의 출력과 같은 세션 개체를 입력하세요. 기본값은 로컬 컴퓨터 상의 현재 세션입니다.


별칭

Session

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-ComputerName<String>

Specifies a DNS server. 이 매개 변수에 허용되는 값은 다음과 같습니다. an IPv4 address, an IPv6 address, and any other value that resolves to an IP address, such as fully qualified domain name (FQDN), Hostname, or NETBIOS name.


별칭

Cn

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-DebugLogging<UInt32>

Specifies the bitmask for debug logging. Valid values are:

0x00000001. The server logs query packet exchanges.

0x00000010. The server logs packet exchanges that are related to zone exchanges.

0x00000020. The server logs packet exchanges that are related to zone updates.

0x0000010.: The server logs packets that contain questions.

0x00000200. The server logs packets that contain answers.

0x00001000. The server logs packets that it sends.

0x00002000. The server logs packets that it receives.

0x00004000. The server logs User Datagram Protocol (UDP) packet exchanges.

0x00008000. The server logs Transmission Control Protocol (TCP) packet exchanges.

0x0000FFFF. The server logs operations if you set the following fields to $True: 0x00001000, 0x00002000, 0x00008000, 0x00004000, 0x00000001, 0x00000001, 0x00000020, 0x00000100, and 0x00000200S.

0x00010000. Independent of other field values, this bitmap logs Active Directory write operations.

0x00020000. Independent of other field values, this bitmap logs Active Directory polling operations and operations that occur during DNS updates (secure and not secure) on Active Directory-integrated zones.

0x01000000. If other field values allow it, the server logs the entire packet to the log file.

0x02000000. If other field values allow it, the server logs response packets that do not match any outstanding queries.

0x80000000. If other field values allow it, the server saves packet logging information to persistent storage.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableLogFileRollover<Boolean>

Specifies whether to enable log file rollover.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableLoggingForLocalLookupEvent<Boolean>

Specifies whether the DNS server logs local lookup events.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableLoggingForPluginDllEvent<Boolean>

Specifies whether the DNS server logs dynamic link library (DLL) plug-in events.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableLoggingForRecursiveLookupEvent<Boolean>

Specifies whether the DNS server logs recursive lookup events.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableLoggingForRemoteServerEvent<Boolean>

Specifies whether the DNS server logs remote server events.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableLoggingForServerStartStopEvent<Boolean>

Specifies whether the DNS server logs server start and stop events.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableLoggingForTombstoneEvent<Boolean>

Specifies whether the DNS server logs tombstone events.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableLoggingForZoneDataWriteEvent<Boolean>

Specifies Controls whether the DNS server logs zone data write events.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableLoggingForZoneLoadingEvent<Boolean>

Specifies whether the DNS server logs zone load events.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EnableLoggingToFile<Boolean>

Specifies whether the DNS server logs logging-to-file.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-EventLogLevel<UInt32>

Specifies an event log level. Valid values are Warning, Error, and None.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-FullPackets<Boolean>

Specifies whether the DNS server logs full packets.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-InformationAction<System.Management.Automation.ActionPreference>

별칭

infa

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-InformationVariable<System.String>

별칭

iv

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-IPFilterList<IPAddress[]>

Specifies an array of IP addresses to filter. When you enable logging, traffic to and from these IP addresses is logged. If you do not specify any IP addresses, traffic to and from all IP addresses is logged.


별칭

FilterIPAddressList

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-LogFilePath<String>

Specifies a log file path.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-MaxMBFileSize<UInt32>

Specifies the maximum size of the log file. This parameter is relevant if you set EnableLogFileRollover and EnableLoggingToFile to $True.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-Notifications<Boolean>

Specifies whether the DNS server logs notifications.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-OperationLogLevel1<UInt32>

Specifies a bit flag for the logging level. Valid values are:

0x00000001. The DNS server saves operational logging information to persistent storage.

0x00000010: The DNS server logs event logging information to a log file.

0x00000020: The DNS server logs operational logging information for server start and stop activities to the log file.

0x00002000: The DNS server logs operational logging information for activities that are related to loading a zone from a directory server to the log file.

0x00004000. The DNS server logs operational logging information for activities that are related to writing zone data to the directory server to the log file.

0x00020000. The DNS server logs operational logging information for activities that are related to updating nodes that have exceeded the tombstone lifetime to the log file.

0x00100000: The DNS server logs operational logging information for local resource lookup activities to the log file.

0x00200000. The DNS server logs operational logging information for activities that occur during recursive query lookup to the log file.

0x00400000. The DNS server logs operational logging information for activities that are related to interaction with remote name servers to the log file.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-OperationLogLevel2<UInt32>

Specifies the additional operations that the DNS server logs. The default valid value is:

0x01000000. Valid values for this parameter are: 0x01, 0x02, and 0x03.The DNS server logs operational logging information for activities that are related to interaction with plug-in DLLs to the log file.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-Queries<Boolean>

Specifies whether the DNS server allows query packet exchanges to pass through the content filter, such as the IPFilterList parameter.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-QuestionTransactions<Boolean>

Specifies whether the DNS server logs queries.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-ReceivePackets<Boolean>

Specifies whether the DNS server logs receive packets.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-SaveLogsToPersistentStorage<Boolean>

Specifies whether the DNS server saves logs to persistent storage.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-SendPackets<Boolean>

Specifies whether the DNS server logs send packets.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-TcpPackets<Boolean>

Specifies whether the DNS server logs TCP packets.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-ThrottleLimit<Int32>

Cmdlet을 실행하도록 설정할 수 있는 동시 작업의 최대 수를 지정합니다. 이 매개 변수를 생략하거나 값으로 0 을 입력하면 Windows PowerShell®은 컴퓨터에서 실행 중인 CIM cmdlet의 수에 따라 cmdlet에 대한 최적의 스로틀 제한을 계산합니다. 스로틀 제한은 현재 cmdlet에만 적용되고, 세션이나 컴퓨터에는 적용되지 않습니다.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-UdpPackets<Boolean>

Specifies whether the DNS server logs UDP packets.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-UnmatchedResponse<Boolean>

Specifies whether the DNS server logs unmatched responses.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-Updates<Boolean>

Specifies whether the DNS server logs updates.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-UseSystemEventLog<Boolean>

Specifies whether the DNS server uses the system event log for logging.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-WriteThrough<Boolean>

Specifies whether the DNS server logs write-throughs.


별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

-Confirm

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


필수 여부

false

위치

named

기본값

false

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-WhatIf

cmdlet이 실행되는 경우 발생할 결과를 보여 줍니다. cmdlet은 실행되지 않습니다.


필수 여부

false

위치

named

기본값

false

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 about_CommonParameters(http://go.microsoft.com/fwlink/p/?LinkID=113216)

<WorkflowParameters>

입력

입력 형식은 cmdlet으로 파이프할 수 있는 개체의 형식입니다.

출력

출력 형식은 cmdlet 실행 시 출력되는 개체의 형식입니다.

참고

  • 0x0. The DNS server does not create a log. This is the default entry.

    0x10. Logs queries.

    0x10. Logs notifications.

    0x20. Logs updates.

    0xFE. Logs non-queries.

    0x100. Logs question transactions.

    0x200. Logs answers.

    0x1000. Logs send packets.

    0x2000. Logs receive packets.

    0x4000. Logs UDP packets.

    0x8000. Logs TCP packets.

    0xFFFF. Logs all packets.

    0x10000. Logs Active Directory write transactions.

    0x20000. Logs Active Directory update transactions.

    0x1000000. Logs full packets.

    0x80000000. Logs write-through transactions.

Example 1: Enable diagnostics for outgoing TCP responses for updates

This command enables the diagnostics of outgoing TCP responses for updates.


PS C:\> Set-DnsServerDiagnostics -SendPackets $True -TcpPackets $True -Answers $True -Updates $True

Example 2: Enable all diagnostic options except for LogFilePath

This command enables all options for DNS server diagnostics except for LogFilePath.


PS C:\> Set-DnsServerDiagnostics -All $True

Example 3: Log send packets

This command logs send packages.


PS C:\> Set-DnsServerDiagnostics -DebugLogging 0x10000

Example 4: Reset debugging settings

This command resets the TCP packet debugging and UDP packet debugging options on DNSServer02 to their values on DNSServer01.


PS C:\> Get-DnsServerDiagnostics -ComputerName "DNSServer01" | select -TcpPackets, -UdpPackets | Set-DnsServerDiagnostics -ComputerName "DNSServer02"

관련 항목

커뮤니티 추가 항목

추가
표시: