DFSNamespaceServerConfiguration

Parameters

Parameter	Attribute	DataType	Description	Allowed Values
IsSingleInstance	Key	String	Specifies the resource is a single instance, the value must be 'Yes'.	Yes
EnableInsiteReferrals	Write	Boolean	Indicates whether this server provides only in-site referrals. Only supported for domain-based DFS namespace servers.
EnableSiteCostedReferrals	Write	Boolean	Indicates whether the server can use cost-based selection. Only supported for domain-based DFS namespace servers.
LdapTimeoutSec	Write	UInt32	Specifies a time-out value, in seconds, for Lightweight Directory Access Protocol (LDAP) requests for the DFS namespace server.
PreferLogonDC	Write	Boolean	Indicates whether to prefer the logon domain controller in referrals. Only supported for domain-based DFS namespace servers.
SyncIntervalSec	Write	UInt32	This interval controls how often domain-based DFS namespace root servers and domain controllers connect to the PDC emulator to get updates of DFS namespace metadata.
UseFQDN	Write	Boolean	Indicates whether a DFS namespace server uses FQDNs in referrals.

Description

This resource is used to configure DFS Namespace server settings. This is a single instance resource that can only be used once in a DSC Configuration.

Examples

Example 1

Create a standalone DFS namespace using FQDN called public on the server fileserver1.contoso.com. A namespace folder called brochures is also created in this namespace that targets the \fileserver2.contoso.com\brochures share.

Configuration DFSNamespaceServerConfiguration_Standalone_FQDN_Config
{
    param
    (
        [Parameter()]
        [PSCredential]
        $Credential
    )

    Import-DscResource -ModuleName 'DFSDsc'

    Node localhost
    {
        <#
            Install the Prerequisite features first
            Requires Windows Server 2012 R2 Full install
        #>
        WindowsFeature RSATDFSMgmtConInstall
        {
            Ensure = 'Present'
            Name = 'RSAT-DFS-Mgmt-Con'
        }

        WindowsFeature DFS
        {
            Name = 'FS-DFS-Namespace'
            Ensure = 'Present'
        }

        # Configure the namespace server
        DFSNamespaceServerConfiguration DFSNamespaceConfig
        {
            IsSingleInstance          = 'Yes'
            UseFQDN                   = $true
            PsDscRunAsCredential      = $Credential
        } # End of DFSNamespaceServerConfiguration Resource

        # Configure the namespace
        DFSNamespaceRoot DFSNamespaceRoot_Standalone_Public
        {
            Path                 = '\\fileserver1.contoso.com\public'
            TargetPath           = '\\fileserver1.contoso.com\public'
            Ensure               = 'Present'
            Type                 = 'Standalone'
            Description          = 'Standalone DFS namespace for storing public files'
            PsDscRunAsCredential = $Credential
        } # End of DFSNamespaceRoot Resource

        # Configure the namespace folder
        DFSNamespaceFolder DFSNamespaceFolder_Standalone_PublicBrochures
        {
            Path                 = '\\fileserver1.contoso.com\public\brochures'
            TargetPath           = '\\fileserver2.contoso.com\brochures'
            Ensure               = 'Present'
            Description          = 'Standalone DFS namespace for storing public brochure files'
            PsDscRunAsCredential = $Credential
        } # End of DFSNamespaceFolder Resource
    }
}