forked from dsccommunity/xPSDesiredStateConfiguration
-
Notifications
You must be signed in to change notification settings - Fork 0
/
xWindowsOptionalFeatureSet_EnableConfig.ps1
79 lines (65 loc) · 2.68 KB
/
xWindowsOptionalFeatureSet_EnableConfig.ps1
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
<#PSScriptInfo
.VERSION 1.0.1
.GUID a2793140-4351-4310-8062-edb2af9f4429
.AUTHOR Microsoft Corporation
.COMPANYNAME Microsoft Corporation
.COPYRIGHT
.TAGS DSCConfiguration
.LICENSEURI https://github.com/dsccommunity/xPSDesiredStateConfiguration/blob/main/LICENSE
.PROJECTURI https://github.com/dsccommunity/xPSDesiredStateConfiguration
.ICONURI
.EXTERNALMODULEDEPENDENCIES
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES First version.
.PRIVATEDATA 2016-Datacenter,2016-Datacenter-Server-Core
#>
#Requires -module 'xPSDesiredStateConfiguration'
<#
.SYNOPSIS
Enables one or more Windows optional features.
.DESCRIPTION
Enables one or more Windows optional features with the specified name and
outputs a log to the specified path.
.PARAMETER Name
The name of one or more Windows optional features to enable.
.PARAMETER LogPath
The path to the file to log the enable operation to.
.NOTES
Can only be run on Windows client operating systems and Windows Server 2012 or later.
The DISM PowerShell module must be available on the target machine.
.EXAMPLE
xWindowsOptionalFeatureSet_EnableConfig -Name @('MicrosoftWindowsPowerShellV2', 'Internet-Explorer-Optional-amd64') -LogPath 'c:\log\feature.log'
Compiles a configuration that enables the Windows optional features
MicrosoftWindowsPowerShellV2 and Internet-Explorer-Optional-amd64 and
outputs a log of the operations to a file at the path 'C:\LogPath\Log.txt'.
.EXAMPLE
Start-AzureRmAutomationDscCompilationJob -ResourceGroupName '<resource-group>' -AutomationAccountName '<automation-account>' -ConfigurationName 'xWindowsOptionalFeatureSet_EnableConfig' -Parameters @{ Name = @('MicrosoftWindowsPowerShellV2', 'Internet-Explorer-Optional-amd64'); LogPath = 'c:\log\feature.log' }
Compiles a configuration in Azure Automation that that enables the
Windows optional features MicrosoftWindowsPowerShellV2 and
Internet-Explorer-Optional-amd64 and outputs a log of the operations to
a file at the path 'C:\LogPath\Log.txt'.
Replace the <resource-group> and <automation-account> with correct values.
#>
Configuration xWindowsOptionalFeatureSet_EnableConfig
{
param
(
[Parameter(Mandatory = $true)]
[System.String[]]
$Name,
[Parameter(Mandatory = $true)]
[System.String]
$LogPath
)
Import-DscResource -ModuleName 'xPSDesiredStateConfiguration'
Node localhost
{
xWindowsOptionalFeatureSet WindowsOptionalFeatureSet1
{
Name = $Name
Ensure = 'Present'
LogPath = $LogPath
}
}
}