DSCResources/DSC_DnsClientGlobalSetting/en-US/about_DnsClientGlobalSetting.help.txt

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
.NAME
    DnsClientGlobalSetting
 
.DESCRIPTION
    This resource is used to control global DNS client settings for a node.
 
.PARAMETER IsSingleInstance
    Key - String
    Allowed values: Yes
    Specifies the resource is a single instance, the value must be 'Yes'.
 
.PARAMETER SuffixSearchList
    Write - StringArray
    Specifies a list of global suffixes that can be used in the specified order by the DNS client for resolving the IP address of the computer name.
 
.PARAMETER UseDevolution
    Write - Boolean
    Specifies that devolution is activated.
 
.PARAMETER DevolutionLevel
    Write - UInt32
    Specifies the number of labels up to which devolution should occur.
 
.EXAMPLE 1
 
Configure only contoso.com for the DNS Suffix.
 
Configuration DnsClientGlobalSetting_ConfigureSuffixSearchListSingle_Config
{
    Import-DscResource -Module NetworkingDsc
 
    Node localhost
    {
        DnsClientGlobalSetting ConfigureSuffixSearchListSingle
        {
            IsSingleInstance = 'Yes'
            SuffixSearchList = 'contoso.com'
            UseDevolution = $true
            DevolutionLevel = 0
        }
    }
}
 
.EXAMPLE 2
 
Configure fabrikam.com and fourthcoffee.com for the DNS SuffixSearchList.
 
Configuration DnsClientGlobalSetting_ConfigureSuffixSearchListMultiple_Config
{
    Import-DscResource -Module NetworkingDsc
 
    Node localhost
    {
        DnsClientGlobalSetting ConfigureSuffixSearchListMultiple
        {
            IsSingleInstance = 'Yes'
            SuffixSearchList = ('fabrikam.com', 'fourthcoffee.com')
            UseDevolution = $true
            DevolutionLevel = 0
        }
    }
}