https://github.com/dsccommunity/xfirefox
https://github.com/dsccommunity/xfirefox
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dsccommunity/xfirefox
- Owner: dsccommunity
- License: mit
- Created: 2015-04-15T22:43:01.000Z (over 11 years ago)
- Default Branch: dev
- Last Pushed: 2019-05-15T20:39:03.000Z (about 7 years ago)
- Last Synced: 2024-03-15T13:47:22.661Z (over 2 years ago)
- Language: PowerShell
- Size: 72.3 KB
- Stars: 8
- Watchers: 18
- Forks: 13
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://ci.appveyor.com/project/PowerShell/xfirefox/branch/master)
# xFirefox
The **xFirefox** module contains the **MSFT_xFirefox** composite resource which allows you to install the Firefox web browser
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
## Contributing
Please check out common DSC Resources [contributing guidelines](https://github.com/PowerShell/DscResource.Kit/blob/master/CONTRIBUTING.md).
## Resources
### MSFT_xFirefox
* **Language**: Specify the language of the browser to be installed.
The default value is English.
* **VersionNumber**: Specify the version number of the browser to be installed.
By default, the latest version is installed.
* **OS**: Specify the operating system on which the browser is to be installed.
By default, the operating system is Windows.
* **MachineBits**: Specifies the machine's operating system bit number.
The default is x86.
* **LocalPath**: The local path on the machine where the installation file should be downloaded.
### MSFT_xFirefoxPreference
* **PreferenceType**: Specify the type of Preference { Pref | lockPref | defaultPref | unlockPref | clearPref }
Specifies the preference type of the Firefox Preference to be configured
* **PreferenceName**: Specify the name of the Preference.
Specifies the name of the Firefox Preference to be configured
* **PreferenceValue**: Specify the value of the Preference.
Specifies value of the Firefox Preference to be configured
* **InstallDirectory**: Specifies the location where Mozilla Firefox is installed.
Specifies the directory where Firefox is installed
## Versions
### Unreleased
### 1.3.0.0
* Update appveyor.yml to use the default template.
* Added default template files .codecov.yml, .gitattributes, and .gitignore, and
.vscode folder.
* The module manifest now contains the correct PowerShell version.
* Added xFirefoxPreference Resource to automate Firefox Preference Configuration
### 1.2.0.0
* Added logic to download installer with correct machine bits
* Added dependency on xPSDesiredStateConfiguration
### 1.1.0.0
* Updated MFST_xFireFox to pull latest version by default and use HTTPS
### 1.0.0.0
* Initial release with the following resources
- MSFT_xFirefox
## Examples
### Install the Firefox browser
```powershell
Configuration Sample_InstallFirefoxBrowser
{
param
(
[Parameter(Mandatory)]
$VersionNumber,
[Parameter(Mandatory)]
$Language,
[Parameter(Mandatory)]
$OS,
[Parameter(Mandatory)]
$LocalPath
)
Import-DscResource -module xFirefox
MSFT_xFirefox Firefox
{
VersionNumber = $VersionNumber
Language = $Language
OS = $OS
LocalPath = $LocalPath
}
}
```