Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

The windows_dfs cookbook has been deprecated

The windows_dfs cookbook has been deprecated and is no longer being maintained by its authors. Use of the windows_dfs cookbook is no longer recommended.


windows_dfs (1) Versions 1.0.0

A Chef resource for managing DFS on Windows hosts

cookbook 'windows_dfs', '~> 1.0.0'
cookbook 'windows_dfs', '~> 1.0.0', :supermarket
knife supermarket install windows_dfs
knife supermarket download windows_dfs
Quality 75%

windows_dfs Cookbook

Cookbook Version Build statusCookbook Version

This cookbook provides a resource for managing DFS on Windows hosts.



  • Windows Server 2012R2
  • Windows Server 2016


  • Chef 13.4+



Sets the server configuration for dfs

### Actions

  • configure : Configures dfs with the specified settings


  • use_fqdn : Indicates whether a DFS namespace server uses FQDNs in referrals. If this parameter has a value of true, the server uses FQDNs in referrals. If this parameter has a value of false, the server uses NetBIOS names. Defaults to false


Creates a folder within dfs as many levels deep as required

### Actions

  • :install : Creates the folder in dfs namespace
  • :remove : Deletes the folder in the dfs namespace

### Properties

  • folder_path : This is the path of the folder to create
  • namespace_name : The namespace this should be created within
  • target_path : The target that this path will connect you to
  • description : Description for the share


windows_dfs_folder "Some\\Nested\\Path" do
      description "Link to MyServer share MyShare"
      namespace_name 'prodshare'
      target_path "\\\\server\\target_share\\Some\\Nested\\Path"
      action :install
windows_dfs_folder "Some\\Nested\\Path" do
      namespace_name 'prodshare'
      action :remove


Creates a dfs namespace on the local server, permissions are set the same as a windows share.

### Actions

  • :install : Creates the dfs namespace on the server

### Properties

  • namespace_name : The name of the namespace to create
  • description : Friendly description for windows to show
  • root : The root from which to create the DFS tree, defaults to C:\DFSRoots
  • full_users : Which users should have full access to the share
  • change_users : Which users should have change access to the share
  • read_users : Which users should have read access to the share
windows_dfs_namespace 'prodshare' do
  description 'Used to easily access shares on other servers'
  action :install
  full_users 'localhost\\users'


Copyright 2018, Calastone Ltd.
Copyright 2018, Chef Software, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

windows >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

CHANGELOG for windows_dfs

This file is used to list changes made in each version of windows_dfs.

1.0.0 (2018-12-28)

  • Initial release

Collaborator Number Metric

1.0.0 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

1.0.0 passed this metric

Foodcritic Metric

1.0.0 passed this metric

No Binaries Metric

1.0.0 passed this metric

Publish Metric

1.0.0 failed this metric

windows_dfs is deprecated

Supported Platforms Metric

1.0.0 passed this metric

Testing File Metric

1.0.0 passed this metric

Version Tag Metric

1.0.0 passed this metric