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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
<!---
This file is reset every time a new release is done. This file describes changes that have not yet been released.
Example Doc Change:
### Headline for the required change
Description of the required change.
-->
### knife ssh has --exit-on-error option
`knife ssh` now has an --exit-on-error option that will cause it to
fail immediately in the face of an SSH connection error. The default
behavior is move on to the next node.
### DSC Resource
The `dsc_resource` resource for Windows systems that allows cookbook authors to invoke [PowerShell Desired
State Configuration](http://technet.microsoft.com/en-us/library/dn249912.aspx) resources in Chef DSL.
#### Prerequisites
* **Windows Management Framework 5** February Preview
* **Local Configuration Manager** must be set to have a `RefreshMode` of `Disabled`
#### Syntax
```ruby
dsc_resource "description" do
resource "resource_name"
property :property_name, property_value
...
property :property_name, property_value
end
```
#### Attributes
- `resource`: The friendly name of the DSC resource
- `property`: `:property_name`, `property_value` pair for each property that must be set for the DSC resource.
`property_name` must be of the `Symbol`. The following types are supported for `property_value`, along with
their conversion into Powershell:
| Ruby Type | Powershell Type |
|-------------------------------------|-----------------|
| Fixnum | Integer |
| Float | Double |
| FalseClass | bool($false) |
| TrueClass | bool($true) |
| Chef::Util::Powershell:PSCredential | PSCredential |
| Hash | Hashtable |
| Array | Object[] |
- `module_name` is the name of the module that the DSC resource comes from. If it is not provided, it will
be inferred.
#### Actions
|Action|Description|
|------|------------------------|
|`:run`| Invoke the DSC resource|
#### Example
```ruby
dsc_resource "demogroupremove" do
resource :group
property :groupname, 'demo1'
property :ensure, 'present'
end
dsc_resource "useradd" do
resource :user
property :username, "Foobar1"
property :fullname, "Foobar1"
property :password, ps_credential("P@assword!")
property :ensure, 'present'
end
dsc_resource "AddFoobar1ToUsers" do
resource :Group
property :GroupName, "demo1"
property :MembersToInclude, ["Foobar1"]
end
```
|
