Get-DnsServerDnsSecZoneSetting

  • 아티클

업데이트 날짜: 2015년 5월

Get-DnsServerDnsSecZoneSetting

Gets DNSSEC settings for a zone.

구문

Parameter Set: DnsSecSetting
Get-DnsServerDnsSecZoneSetting [-ZoneName] <String[]> [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

Parameter Set: SigningMetadata
Get-DnsServerDnsSecZoneSetting [-ZoneName] <String[]> -SigningMetadata [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-IncludeKSKMetadata] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>] [ <WorkflowParameters>]

자세한 설명

The Get-DnsServerDnsSecZoneSetting cmdlet gets the Domain Name System Security Extensions (DNSSEC) settings for a zone on a Domain Name System (DNS) server.

If you specify the SigningMetaData parameter, the cmdlet outputs a signing metadata object that contains all the configuration information about the zone signing. You can use this object to import the configuration for zone signing to another server by using the Set-DnsServerDnsSecZoneSetting cmdlet.

매개 변수

-CimSession<CimSession[]>

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

별칭

Session

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-ComputerName<String>

Specifies a DNS server. If you do not specify this parameter, the command runs on the local system. You can specify an IP address or any value that resolves to an IP address, such as a fully qualified domain name (FQDN), host name, or NETBIOS name.

별칭

Cn

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-IncludeKSKMetadata

Indicates that the cmdlet includes KSK metadata in the output object. You can import the output object that contains the KSK metadata on another server. If the server that imports the input object requires the Key Master role, the server can seize the Key Master role. If the output object does not contain the KSK metadata, the server that imports the output object cannot seize the key Master Role while retaining the existing keys, and you must resign the whole zone with new keys.

별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-InformationAction<System.Management.Automation.ActionPreference>

별칭

infa

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-InformationVariable<System.String>

별칭

iv

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-SigningMetadata

Indicates that the cmdlet includes all signing metadata in the output object.

별칭

none

필수 여부

true

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-ThrottleLimit<Int32>

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

별칭

none

필수 여부

false

위치

named

기본값

none

파이프라인 입력 허용 여부

false

와일드카드 문자 허용 여부

false

-ZoneName<String[]>

Specifies an array of names of DNS zones.

별칭

none

필수 여부

true

위치

2

기본값

none

파이프라인 입력 허용 여부

True (ByPropertyName)

와일드카드 문자 허용 여부

false

<CommonParameters>

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

<WorkflowParameters>

입력

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

출력

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

  • Microsoft.Management.Infrastructure.CimInstance#DnsServerDnsSecZoneSetting[]

    The DnsServerDnsSecZoneSetting object contains the following fields:

    -- DenialOfExistence
    -- DistributeTrustAnchor
    -- DnsKeyRecordSetTtl
    -- DSRecordGenerationAlgorithm
    -- DSRecordSetTtl
    -- EnableRfc5011KeyRollover
    -- IsKeyMasterServer
    -- KeyMasterServer
    -- KeyMasterStatus
    -- NSec3HashAlgorithm
    -- NSec3Iterations
    -- NSec3OptOut
    -- NSec3RandomSaltLength
    -- NSec3UserSalt
    -- ParentHasSecureDelegation
    -- PropagationTime
    -- SecureDelegationPollingPeriod
    -- SignatureInceptionOffset
    -- ZoneName

    If you specify the SigningMetadata parameter, the object returned is of type DnsServerZoneSigningMetadata
    {
    DnsServerDnsSecZoneSetting DnsSecZoneSetting
    DnsServerSigningKeyExtendedInformation [] KeyExtendedInformation
    DnsServerResourceRecord[] DnsSecRecords
    }
    DnsServerDnsSecZoneSetting
    {
    -- String ZoneName
    -- Bool DenialOfExistence
    -- Bool NSec3HashAlgorithm
    -- Integer NSec3Iterations
    -- Bool NSec3OptOut
    -- Integer NSec3RandomSaltLength
    -- String NSec3UserSalt
    -- String[] DistributeTrustAnchor
    -- Bool EnableRfc5011KeyRollover
    -- String[] DSRecordGenerationAlgorithm
    -- Bool ParentHasSecureDelegation
    -- DateTime DsRecordSetTtl
    -- DateTime DnsKeyRecordSetTtl
    -- DateTime SignatureInceptionOffset
    -- DateTime SecureDelegationPollingPeriod
    -- DateTime PropogationTime
    -- Bool IsKeyMasterServer
    -- String KeyMasterServer
    -- String KeyMasterStatus
    -- Bool IsSigned
    -- String NSec3CurrentSalt
    -- String CurrentRollingSkdGuid
    }
    DnsServerSigningKeyOpState
    {
    -- Integer CurrentRolloverState
    -- Bool ManualTrigger
    -- Integer PreRollEventFired
    -- TimeSpan NextKeyGenerationTime
    -- DnsServerResourceRecordDnsKey[] RevokedOrSwappedDnsKeys
    -- DnsServerResourceRecordDnsKey[] FinalDnsKeys
    -- Integer ActiveKeyScope
    -- Integer StandbyKeyScope
    -- Integer NextKeyScope
    }
    DnsServerSigningKeyExtendedInformation
    {
    -- DnsServerSigningKey SigningKey
    -- DnsServerSigningKeyOpState SigningKeyOpState
    }

예

Example 1: Get DNSSEC settings

This command gets the DNS Security Extensions for the zone named western.contoso.com.

PS C:\> Get-DnsServerDnsSecZoneSetting -ZoneName "western.contoso.com"

Example 2: Get DNSSEC setting with signing metadata

This command gets the DNS Security Extensions signing metadata for the zone named western.contoso.com. The metadata returned can be imported on a non-key master server to begin signing with enhanced key management for file-backed zones.

PS C:\> Get-DnsServerDnsSecZoneSetting -SigningMetadata -ZoneName western.contoso.com

Example 3: Get DNSSEC settings with signing metadata and key signing key information

This command gets the DNS Security Extensions signing metadata and key signing key information for the zone named western.contoso.com. The metadata returned can be imported on a non-key master server to begin signing with enhanced key management for file-backed zones.

PS C:\> Get-DnsServerDnsSecZoneSetting -SigningMetadata -ZoneName "western.contoso.com" -IncludeKSKMetadata

관련 항목

Set-DnsServerDnsSecZoneSetting

Test-DnsServerDnsSecZoneSetting