Set-DAClientDnsConfiguration

아티클
11/16/2015

Set-DAClientDnsConfiguration

Configures the DNS server and proxy server addresses of a Name Resolution Policy Table (NRPT) entry and configures the local name resolution property.

구문

Parameter Set: Set3
Set-DAClientDnsConfiguration [-AsJob] [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-DnsIPAddress <String[]> ] [-DnsSuffix <String> ] [-Local <String> ] [-PassThru] [-ProxyServer <String> ] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

자세한 설명

The Set-DAClientDnsConfiguration cmdlet configures the DNS server and proxy server addresses of a Name Resolution Policy Table (NRPT) entry and configures the local name resolution property.

To modify an NRPT entry the user needs to specify the DNS suffix, the new DNS IP address or the proxy server, or the new DNS IP address and the proxy server for this suffix. To modify the local name resolution setting the Local parameter is used.

When an NRPT entry or local name resolution property is modified in a multi-domain scenario, it is correspondingly updated in all of the client Group Policy Objects (GPOs) in various domains. This is true for multi-site and GPOs as well.

The NRPT configuration is applicable globally to the entire DirectAccess (DA) deployment and therefore is not impacted by multi-site deployment.

매개 변수

-AsJob

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-CimSession<CimSession[]>

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

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-ComputerName<String>

Specifies the IPv4 or IPv6 address, or host name, of the computer on which the Remote Access server computer specific tasks should be run.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-DnsIPAddress<String[]>

Specifies the new list of DNS server IPv4 or IPv6 addresses for the specified DNS suffix in the NRPT.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	true (ByPropertyName)
와일드카드 문자 허용 여부	false

-DnsSuffix<String>

Specifies the DNS suffix entry in the NRPT that needs to be modified.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	true (ByPropertyName)
와일드카드 문자 허용 여부	true

-Local<String>

Specifies the property of the local name resolution. 이 매개 변수에 허용되는 값은 다음과 같습니다.
-- FallbackSecure: Only use local name resolution if the name does not exist in DNS, which is most restrictive.
-- FallbackPrivate: Fall back to local name resolution if the name does not exist in the DNS or the DNS servers are unreachable when the client computer is on a private network, which is recommended.
-- FallbackUnsecure: Fall back to local name resolution for any kind of DNS resolution error, which is least secure.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	true (ByPropertyName)
와일드카드 문자 허용 여부	false

-PassThru

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

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-ProxyServer<String>

Specifies the new proxy server for the specified DNS suffix in the NRPT.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	true (ByPropertyName)
와일드카드 문자 허용 여부	false

-ThrottleLimit<Int32>

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

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Confirm

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

필수 여부	false
위치	named
기본값	false
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

필수 여부	false
위치	named
기본값	false
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

None

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

Microsoft.Management.Infrastructure.CimInstance#DAClientDnsConfiguration

Microsoft.Management.Infrastructure.CimInstance 개체는 WMI(Windows Management Instrumentation) 개체를 표시하는 래퍼 클래스입니다. 파운드 기호(#) 뒤에 오는 경로는 기본 WMI 개체의 네임스페이스 및 클래스 이름을 제공합니다.
The DAClientDnsConfiguration object contains the following properties:
-- The NRPT entries in the NRPT table: each entry is an instance of the DnsClientNrptRule object.
-- The DnsClientNrptGlobal object which contains the local name resolution settings.

예제

EXAMPLE 1

This example will change the list of configured DNS Servers for contoso.com to 2006:2005:1::3. These changes will be made in all of the DA client GPOs.

PS C:\> Set-DAClientDNSConfiguration -DNSSuffix 'contoso.com' -DnsIPAddress 2006:2005:1::3

EXAMPLE 2

This example configures a proxy server for suffix contoso.com. Since NRPT entry settings in DA are global, this change will apply to all of the DA clients.

PS C:\> Set-DAClientDNSConfiguration -DNSSuffix 'contoso.com' -ProxyServer 'webproxy.contoso.com:400'

EXAMPLE 3

This example configures local name resolution to FallbackSecure, therefore ensuring that local name resolution is used only if the resource name does not exist in DNS.

PS C:\> Set-DAClientDnsConfiguration -Local 'FallbackSecure'

Set-DAClientDnsConfiguration