DFSDsc

5.0.0

DSCResources/DSC_DFSNamespaceServerConfiguration/en-US/about_DFSNamespaceServerConfiguration.help.txt

.NAME
    DFSNamespaceServerConfiguration
 
.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.
 
.PARAMETER IsSingleInstance
    Key - String
    Allowed values: Yes
    Specifies the resource is a single instance, the value must be 'Yes'.
 
.PARAMETER LdapTimeoutSec
    Write - UInt32
    Specifies a time-out value, in seconds, for Lightweight Directory Access Protocol (LDAP) requests for the DFS namespace server.
 
.PARAMETER 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.
 
.PARAMETER UseFQDN
    Write - Boolean
    Indicates whether a DFS namespace server uses FQDNs in referrals.
 
.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
    }
}