https://github.com/dsccommunity/xinternetexplorerhomepage
https://github.com/dsccommunity/xinternetexplorerhomepage
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dsccommunity/xinternetexplorerhomepage
- Owner: dsccommunity
- License: mit
- Created: 2015-04-15T22:43:01.000Z (over 11 years ago)
- Default Branch: dev
- Last Pushed: 2018-09-22T10:15:39.000Z (almost 8 years ago)
- Last Synced: 2025-04-09T22:27:44.765Z (over 1 year ago)
- Language: PowerShell
- Size: 22.5 KB
- Stars: 5
- Watchers: 19
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://ci.appveyor.com/project/PowerShell/xinternetexplorerhomepage/branch/master)
# xInternetExplorerHomePage
The **xInternetExplorerHomePage** modules contains the **xInternetExplorerHomePage** resource, enabling you to set one or more IE home pages.
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
### xInternetExplorerHomePage
* **StartPage**: Specifies the home page of Internet Explorer.
* **SecondaryStartPages**: Specifies the secondary home pages of Internet Explorer.
* **Ensure**: Ensures that the IE home page is Present or Absent.
## Versions
### Unreleased
* Update appveyor.yml to use the default template.
* Added default template files .codecov.yml, .gitattributes, and .gitignore, and
.vscode folder.
### 1.0.0.0
* Initial release with the following resources
* xInternetExplorerHomePage
## Examples
### Set the Internet Explorer home page
```powershell
Configuration SetIEHomePage
{
Param
(
#Target nodes to apply the configuration
[String[]]$NodeName = $env:COMPUTERNAME,
#Specifies the URL for the home page of Internet Explorer.
[Parameter(Mandatory)]
[ValidateNotNullOrEmpty()]
[String]$StartPageURL,
#Specifies the URL for the secondary home pages of Internet Explorer.
[Parameter()]
[String]$SecondaryStartPagesURL,
#Set the value as 'Present'/'Absent', it indicates the IE home page is configured/unconfigured.
[Parameter(Mandatory)]
[ValidateSet('Present','Absent')]
[String]$SetEnsure
)
Import-DSCResource -ModuleName xInternetExplorerHomePage
Node "localhost"
{
xInternetExplorerHomePage IEHomePage
{
StartPage = $StartPageURL
SecondaryStartPages = $SecondaryStartPagesURL
Ensure = $SetEnsure
}
}
}
SetIEHomePage -StartPageURL "www.bing.com" -SetEnsure 'Present'
Start-DscConfiguration -Path .\SetIEHomePage -Wait -Force -Verbose
```
### Set the Secondary start page
```powershell
Configuration SetIEHomePage
{
Param
(
#Target nodes to apply the configuration
[String[]]$NodeName = $env:COMPUTERNAME,
#Specifies the URL for the home page of Internet Explorer.
[Parameter(Mandatory)]
[ValidateNotNullOrEmpty()]
[String]$StartPageURL,
#Specifies the URL for the secondary home pages of Internet Explorer.
[Parameter()]
[String]$SecondaryStartPagesURL,
#Set the value as 'Present'/'Absent', it indicates the IE home page is configured/unconfigured.
[Parameter(Mandatory)]
[ValidateSet('Present','Absent')]
[String]$SetEnsure
)
Import-DSCResource -ModuleName xInternetExplorerHomePage
Node "localhost"
{
xInternetExplorerHomePage IEHomePage
{
StartPage = $StartPageURL
SecondaryStartPages = $SecondaryStartPagesURL
Ensure = $SetEnsure
}
}
}
SetIEHomePage -StartPageURL "www.bing.com" -SecondaryStartPagesURL "www.google.com" -SetEnsure 'Present'
Start-DscConfiguration -Path .\SetIEHomePage -Wait -Force -Verbose
```