[5] Window PowerShell DSC 学习系列----如何生成一个DSC MOF文件？

在前面的四个章节，笔者介绍了一些PowerShell基础的知识，包括PowerShell DSC的基本架构，DSC的资源以及配置格式，已经在PowerShell DSC 如何安装扩展的DSC Module和resource；还有一些基本的DSC辅助命令的使用。那么本节，咱们就安装一个Chrome插件的DSC配置文件为例子，看其如何生成一个mof文件。打开Powershell ISE或者一个文本编辑器，新建一个文件名为：InstallGoogleChrome.ps1的配置文件，放在c:\dsc 目录下。内容如下：

Configuration InstallGoogleChrome {
    param (
        [string[]]$MachineName = "localhost",
        [Parameter(Mandatory)]$Language,
        [Parameter(Mandatory)]$LocalPath
    )
 
    Import-DscResource -Module xChrome
 
    Node $MachineName {
        MSFT_xChrome chrome {
            Language = $Language
            LocalPath = $LocalPath
        }
    }
}
 
InstallGoogleChrome -MachineName (Get-Content -Path "c:\dsc\servers.txt") -Language "en" –LocalPath "C:\Windows\Temp\GoogleChromeStandaloneEnterprise.msi"

注意：在ps1文件的最后一行，一定要把Configuration后的名字加上，  InstallGoogleChrome，后面的参数是可选的。否则其将会生成不了MOF文件。

其中，引用的到的c:\dsc\servers.txt服务器列表如下：

pserver51w2k12
dscc01-51w2k12
dscc02-51w2008

然后在PowerShell 命令行中输入下面的命令：

PS C:\dsc> .\InstallGoogleChrome
WARNING: The configuration 'InstallGoogleChrome' is loading one or more built-in resources without explicitly importing
 associated modules. Add Import-DscResource –ModuleName 'PSDesiredStateConfiguration' to your configuration to avoid
this message.


    Directory: C:\dsc\InstallGoogleChrome


Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        1/23/2017   8:00 AM           3998 pserver51w2k12.mof
-a----        1/23/2017   8:00 AM           3998 dscc01-51w2k12.mof
-a----        1/23/2017   8:00 AM           3998 dscc02-51w2008.mof

注意，上面会弹出一个警告信息，然后修改InstallGoogleChrome.ps1文件，显式加上Import-DscResource –ModuleName 'PSDesiredStateConfiguration' 这一行。

Configuration InstallGoogleChrome {
    param (
        [string[]]$MachineName = "localhost",
        [Parameter(Mandatory)]$Language,
        [Parameter(Mandatory)]$LocalPath
    )
 
    Import-DscResource -Module xChrome
    Import-DscResource –ModuleName 'PSDesiredStateConfiguration'
	
    Node $MachineName {
        MSFT_xChrome chrome {
            Language = $Language
            LocalPath = $LocalPath
        }
    }
}
 
InstallGoogleChrome -MachineName (Get-Content -Path "c:\dsc\servers.txt") -Language "en" –LocalPath "C:\Windows\Temp\GoogleChromeStandaloneEnterprise.msi"

非常好！ 警告信息消失，重新执行一遍。

PS C:\dsc> .\InstallGoogleChrome

    Directory: C:\dsc\InstallGoogleChrome

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        1/23/2017   8:01 AM           3998 pserver51w2k12.mof
-a----        1/23/2017   8:01 AM           3998 dscc01-51w2k12.mof
-a----        1/23/2017   8:01 AM           3998 dscc02-51w2008.mof

到此为止，三个虚拟机上的三个mof文件已经生成。

打开其中的一个MOF文件查看。

/*
@TargetNode='dscc01-51w2k12'
@GeneratedBy=Admin
@GenerationDate=01/23/2017 08:01:31
@GenerationHost=PULLSERVERWMF51
*/

instance of MSFT_xRemoteFile as $MSFT_xRemoteFile1ref
{
ResourceID = "[xRemoteFile]Downloader::[MSFT_xChrome]chrome";
 Uri = "https://dl.google.com/tag/s/appguid={8A69D345-D564-463C-AFF1-A69D9E530F96}&iid={00000000-0000-0000-0000-000000000000}&lang=en&browser=3&usagestats=0&appname=Google%2520Chrome&needsadmin=prefers/edgedl/chrome/install/GoogleChromeStandaloneEnterprise.msi";
 DestinationPath = "C:\\Windows\\Temp\\GoogleChromeStandaloneEnterprise.msi";
 ModuleName = "xPSDesiredStateConfiguration";
 SourceInfo = "C:\\Program Files\\WindowsPowerShell\\Modules\\xChrome\\1.1.0.0\\DSCResources\\MSFT_xChrome\\MSFT_xChrome.schema.psm1::15::5::xRemoteFile";
 ModuleVersion = "5.1.0.0";

 ConfigurationName = "InstallGoogleChrome";

};
instance of MSFT_PackageResource as $MSFT_PackageResource1ref
{
ResourceID = "[Package]Installer::[MSFT_xChrome]chrome";
 Path = "C:\\Windows\\Temp\\GoogleChromeStandaloneEnterprise.msi";
 Ensure = "Present";
 ProductId = "";
 SourceInfo = "C:\\Program Files\\WindowsPowerShell\\Modules\\xChrome\\1.1.0.0\\DSCResources\\MSFT_xChrome\\MSFT_xChrome.schema.psm1::21::5::Package";
 Name = "Google Chrome";
 ModuleName = "PSDesiredStateConfiguration";

ModuleVersion = "1.0";

DependsOn = {

    "[xRemoteFile]Downloader::[MSFT_xChrome]chrome"};

 ConfigurationName = "InstallGoogleChrome";

};
instance of OMI_ConfigurationDocument


                    {
 Version="2.0.0";
 

                        MinimumCompatibleVersion = "1.0.0";
 

                        CompatibleVersionAdditionalProperties= {"Omi_BaseResource:ConfigurationName"};
 

                        Author="Admin";
 

                        GenerationDate="01/23/2017 08:01:31";
 

                        GenerationHost="PULLSERVERWMF51";
 

                        Name="InstallGoogleChrome";


                    };

恭喜你！！！ MoF文件已经成功生成！！！

末了，给大家分享一个小小的经验，当我们在写DSC Configuration的文件的时候，其中会用到一些DSC的资源（Resource），那么我们如何知道这些DSC的资源的包含哪些输入参数呢？可以通 Get-DscResource -Name  Registry -Syntax 来查看DSC的资源的输入格式。比如，下面的例子：

PS C:\dsc> Get-DscResource -Name MSFT_xChrome   -Syntax

MSFT_xChrome [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    [Language = [String]]
    [LocalPath = [String]]
}

我们知道，对于MSFT_xChrome的Resource，支持哪些输入参数。