murrahjm / dfsdsc

DSC Resource for configuring Windows Distributed File System (Replication and Namespaces)

DFSDsc

The DFSDsc module contains DSC resources for configuring Distributed File System Replication and Namespaces. Currently in this version only Replication folders are supported. Namespaces will be supported in a future release.

The DFSDsc module contains the following resources:

• DFSNamespaceFolder: Create, edit or remove folders from DFS namespaces.
• DFSNamespaceRoot: Create, edit or remove standalone or domain based DFS namespaces.
• DFSNamespaceServerConfiguration: Configure DFS Namespace server settings.
• DFSReplicationGroup: Create, edit or remove DFS Replication Groups.
• DFSReplicationGroupConnection: Create, edit and remove DFS Replication Group connections.
• DFSReplicationGroupFolder: Configure DFS Replication Group folders.
• DFSReplicationGroupMembership: Configure Replication Group Folder Membership.

This project has adopted this code of conduct.

Documentation and Examples

For a full list of resources in DFSDsc and examples on their use, check out the DFSDsc wiki.

Branches

master

This is the branch containing the latest release - no contributions should be made directly to this branch.

dev

This is the development branch to which contributions should be proposed by contributors as pull requests. This development branch will periodically be merged to the master branch, and be released to PowerShell Gallery.

Requirements

Windows Management Framework 5.0

Required because the PSDSCRunAsCredential DSC Resource parameter is needed.

Because this resource is configuring information within Active Directory, the PSDSCRunAsCredential property must be used with a credential of a domain user that can work with DFS information. This means that this resource can only work on computers with Windows Management Framework 5.0 or above.

Important Information

DFSR Module

This DSC Resource requires that the DFSR PowerShell module is installed onto any computer this resource will be used on. This module is installed as part of RSAT tools or RSAT-DFS-Mgmt-Con Windows Feature in Windows Server 2012 R2. However, this will automatically convert a Server Core installation into one containing the management tools, which may not be ideal because it is no longer strictly a Server Core installation. Because this DSC Resource actually only configures information within the AD, it is only required that this resource is run on a computer that is registered in AD. It doesn't need to be run on one of the File Servers participating in the Distributed File System or Namespace.

Contributing

Please check out common DSC Resources contributing guidelines.