Website under construction

PartialConfiguration
resource defines configuration fragments. Two partial configurations, 
IISInstall
and 
IndexFile
, are defined. 
IISInstall
configuration is available on 
PullServer1
, whereas 
IndexFile
configuration is available on 
PullServer2
. Important to note are the names of the partial 
configurations because they should exactly match the names of the configurations on the pull server. 
The next section will show that the 
IISInstall
configuration is authored and available on 
PullServer1
and the 
IndexFile
configuration is available on 
PullServer1
. The 
ConfigurationSource
property 
attaches the pull server to the partial configuration. 
Also, note that the pull server URL, 
ConfigurationID
, and Configuration Name combined provide the 
LCM with complete information to uniquely identify the configuration on the pull server. The LCM 
cannot pull partial configurations if any of these three pieces of information is missing. 
The configuration previously shown generates the DemoServerWin.meta.mof file at the C:\DSC folder 
location. You use the Set-DSCLocalConfigurationManager cmdlet to push and apply the .mof file to 
DemoServerWin. 
Authoring the configurations 
Next, we examine authoring the configurations that will participate in partial configuration. In this 
section, two configurations, 
IISInstall
and 
IndexFile
, are authored. 
IISInstall configuration 
This is a simple configuration responsible for installing IIS (Web-Server) on a server using the 
WindowsFeature
resource. Running the configurations in this section and the next one generates 
.mof files. The configuration script in our sample that follows runs on server ServerWin10. The 
name of the .mof file is same as the node name defined in the configuration script. Configurations 
participating in partial configurations have a special naming requirement. They must use the 
..mof format. The configuration shown in the following 
sample uses ConfigurationData (data structure for passing values to configuration script) to define the 
name of the node. $AllNodes.NodeName retrieves all the node names from the configuration data, 
which in this case is only one because there is just one NodeName. IISInstall.fcd03a8d-5a64-4982-
92b3-5c89680add39.MOF is generated from the following script: 
$ConfigInfoIIS = @{ 
AllNodes = @( 
@{ 
NodeName = "IISInstall.fcd03a8d-5a64-4982-92b3-5c89680add39" 
} 
) 
} 
Configuration IISInstall 
{ 
Node $AllNodes.NodeName 
{ 
WindowsFeature IIS 
{ 
Name = "Web-server" 
Ensure = "Present" 
} 

---

150 
CHAPTER 5 | Systems management 
} 
} 
IISInstall -OutputPath 'C:\Program Files\WindowsPowerShell\DscService\Configuration' -ConfigurationData 
$ConfigInfoIIS 
New-DSCCheckSum -ConfigurationPath 'C:\Program Files\WindowsPowerShell\DscService\Configuration' -OutPath 
'C:\Program Files\WindowsPowerShell\DscService\Configuration' 
You should place the .mof files on pull server WinServer10 in a well-defined folder, typically in 
C:\Program Files\WindowsPowerShell\DSCService\Configuration. When the .mof file is generated, this 
folder location is passed as a parameter for the 
OutPath
attribute. 
After .mof file generation, the checksum file for the configuration needs to be generated. The 
checksum determines if a new configuration exists on the pull server or not. It also helps to verify the 
integrity of configurations when they are transmitted between the pull server and the LCM. The 
checksum file must have the same name as the .mof file with .mof.checksum as an extension. DSC 
provides the New-DSCCheckSum cmdlet to generate the checksum file. The 
ConfigurationPath
parameter specifies the folder location where configurations are stored. The cmdlet generates a 
checksum file for each configuration and saves the checksum in the folder location specified by the 
OutPath
parameter.