dsccommunity/xchrome

xChrome

The xChrome module is a part of the Windows PowerShell Desired State Configuration (DSC) Resource Kit, which is a collection of DSC Resources produced by the PowerShell Team. This module contains the MSFT_xChrome resource. The MSFT_xChrome DSC Resource allows you to install the latest version of Google Chrome.

All of the resources in this module are provided AS IS, and are not supported through any Microsoft standard support program or service. The "x" prefix in the module name stands for "experimental," which means that these resources will be fix-forward and monitored by the module owner(s).

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Installation

To install xChrome PowerShell DSC module:

• Unzip the content under the $env:ProgramFiles\WindowsPowerShell\Modules folder
• OR Run Install-Module -Name xChrome from an administrative PowerShell prompt

To confirm installation:

• Run Get-DSCResource -Module xChrome to see that MSFT_xChrome is among the DSC Resources listed
• Run the Get-Module -ListAvailable -Name xChrome command to verify that the xChrome DSC module is listed

Requirements

This module requires the latest version of PowerShell (v4.0, which ships in Windows 8.1 or Windows Server 2012R2). To easily use PowerShell 4.0 on older operating systems, install WMF 4.0. Please read the installation instructions that are present on both the download page and the release notes for WMF 4.0.

Description

The xChrome module contains the MSFT_xChrome DSC Resource. This DSC Resource allows you to install the latest version of chrome.

Details

The MSFT_xChrome DSC Resource has following optional properties:

• Language: Specify the language of the browser to be installed.Default it is English.
• LocalPath: The local location on the machine which can you used to place the downloaded installation file.

Versions

Unreleased

• Update appveyor.yml to use the default template.
• Added default template files .codecov.yml, .gitattributes, and .gitignore and .vscode folder.
• The module manifest now contain the correct PowerShell version (issue #17).

1.1.0.0

• Added missing dependency on xPSDesiredStateConfiguration

1.0.2.0

• Minor documentation updates

1.0.1.0

• Minor changes in module manifest

1.0.0.0

• Initial release with the following resources
  • MSFT_xChrome

Examples

Install the Chrome browser

Install the latest Google Chrome web browser.

# Installs the latest version of Chrome in the language specified in the parameter Language.

Configuration Sample_InstallChromeBrowser
{
    param
    (
    [Parameter(Mandatory)]
    $Language,

    [Parameter(Mandatory)]
    $LocalPath

    )

    Import-DscResource -module xChrome

    MSFT_xChrome chrome
    {
    Language = $Language
    LocalPath = $LocalPath
    }
}

Contributing

Please check out common DSC Resources contributing guidelines.

xchrome's Issues

xChrome: Converting to new CI pipeline

Work need to be done to convert this repository to use the new CI pipeline.

https://dsccommunity.org/blog/convert-a-module-for-continuous-delivery/

Fails on the common test due to it's a composite resource

Fails on the common test, due to that the test framework does not support composite resource at the moment.

    Context DSCResources\MSFT_xChrome\MSFT_xChrome.schema.psm1
There are parse errors in C:\projects\xchrome\DSCResources\MSFT_xChrome\MSFT_xChrome.schema.psm1:
Extent          : Import-DscResource -ModuleName xPSDesiredStateConfiguration
ErrorId         : ModuleNotFoundDuringParse
Message         : Could not find the module 'xPSDesiredStateConfiguration'.
IncompleteInput : False
Extent          : xRemoteFile
ErrorId         : ResourceNotDefined
Message         : Undefined DSC resource 'xRemoteFile'. Use Import-DSCResource to import the resource.
IncompleteInput : False
      [-] Module file 'DSCResources\MSFT_xChrome\MSFT_xChrome.schema.psm1' should not contain parse errors 95ms
        Expected $false, but got $true.
        248:                 $containsParseErrors | Should -Be $false
        at <ScriptBlock>, C:\projects\xchrome\DscResource.Tests\Meta.Tests.ps1: line 248
  Describing Common Tests - Validate Module Files

Missing dependency

This module requires 'xPSDesiredStateConfiguration' module to work.

PowerShell Gallery module missing DSC resources?

If I install the xChrome module into an Azure Automation DSC instance (from the gallery) and attempt to use it to install Chrome as described here Azure DSC automation fails to compile the configuration because it can't find MSFT_xChrome. It looks like there is something wrong with the contents of what is in the PowerShell gallery because it does not list any "DSC Resources" on the summary page in the gallery.

For example:
xChrome does not list DSC Resources and module does not work
xFirefox does not list DSC Resources and module does not work
cChoco does list DSC Resources and module does work

Module manifest does not contain property PowerShellVersion

Common test fail on the module manifest property PowerShellVersion.

  Describing Common Tests - Module Manifest
    [-] Should contain a PowerShellVersion property of at least 4.0 based on resource types 125ms
      Expected $true, but got $false.
      303:         $moduleManifestProperties.PowerShellVersion -ge $minimumPSVersion | Should -Be $true
      at <ScriptBlock>, C:\projects\xchrome\DscResource.Tests\Meta.Tests.ps1: line 303
  Describing Common Tests - Script Resource Schema Validation