Public/Start-MDSWebBrowser.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
Function Start-MDSWebBrowser {
    <#
    .SYNOPSIS
    Opens a web browser as the current user or as the user of the credentials provided

    .DESCRIPTION
    Opens a web browser as the current user or as the user of the credentials provided. Defaults to Internet Explorer.

    .EXAMPLE
    Start-MDSWebBrowswer -MDSCredential $MDSCredentialName

    .EXAMPLE
    Start-MDSWebBrowswer -Credential -Browser Chrome

    .NOTES

    #>


    [System.Diagnostics.CodeAnalysis.SuppressMessage('PSAvoidUsingPlainTextForPassword', '')]
    [System.Diagnostics.CodeAnalysis.SuppressMessage('PSUsePSCredentialType', '')]

    [CmdletBinding(
        SupportsShouldProcess,
        DefaultParameterSetName='MDSCredential'
    )]
    Param(
        [parameter(Position=0,ParameterSetName='MDSCredential')]
        [String]$MDSCredential,

        [parameter(Position=0,ParameterSetName='Credential')]
        [ValidateNotNullOrEmpty()]
        [System.Management.Automation.CredentialAttribute()]
        $Credential,

        [parameter(Position=1,ParameterSetName='MDSCredential')]
        [parameter(Position=1,ParameterSetName='Credential')]
        [ValidateSet('IE','Chrome')]
        [string]$Browser='IE'
    )

    Begin {}
    Process {
        Try {
            $ProcessPath = Switch ($Browser) {
                IE      {'C:\Program Files\Internet Explorer\iexplore.exe'}
                Chrome  {'C:\Program Files (x86)\Google\Chrome\Application\chrome.exe'}
                Default {}
            }
            # Variable for storing parameters
            $Parameters = @{}

            # MDSCredential
            If ($PSBoundParameters.MDSCredential) {
                $Credential = Get-MDSCredential -Name $MDSCredential -ErrorAction Stop
            }

            # Add credentials to parameter list
            If ($null -ne $Credential) {
                $Parameters.Add('Credential',$Credential)
            }

            # For use in Confirm & WhatIf
            $ShouldProcessTarget = "Username: {0}, Browser: {1}" -f $Credential.UserName,$Browser

            # Execute Explorer
            If ($PSCmdlet.ShouldProcess($ShouldProcessTarget,$MyInvocation.MyCommand)) {
                Start-Process $ProcessPath @Parameters -LoadUserProfile
            }
        }
        Catch {
            Write-Error $PSItem
        }
    }
    End {}
}