functions/Get-DbaSpn.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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
function Get-DbaSpn
{
<#
.SYNOPSIS
Returns a list of set service principal names for a given computer/AD account
 
.DESCRIPTION
Get a list of set SPNs. SPNs are set at the AD account level. You can either retrieve set SPNs for a computer, or any SPNs set for
a given active directry account. You can query one, or both. You'll get a list of every SPN found for either search term.
 
.PARAMETER ComputerName
The servers you want to return set SPNs for.
 
.PARAMETER AccountName
The accounts you want to retrieve set SPNs for.
 
.PARAMETER Credential
User credential to connect to the remote servers or active directory. This is a required parameter.
 
.NOTES
Author: Drew Furgiuele (@pittfurg), http://www.port1433.com
  
dbatools PowerShell module (https://dbatools.io)
Copyright (C) 2016 Chrissy LeMaire
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
 
  
.LINK
https://dbatools.io/Get-DbaSpn
 
.EXAMPLE
Get-DbaSpn -ServerName SQLSERVERA -Credential (Get-Credential)
 
Returns a custom object with SearchTerm (ServerName) and the SPNs that were found
 
.EXAMPLE
Get-DbaSpn -AccountName doamain\account -Credential (Get-Credential)
 
Returns a custom object with SearchTerm (domain account) and the SPNs that were found
 
.EXAMPLE
Get-DbaSpn -ServerName SQLSERVERA,SQLSERVERB -Credential (Get-Credential)
 
Returns a custom object with SearchTerm (ServerName) and the SPNs that were found for multiple computers
#>

    [cmdletbinding()]
    param(
        [Parameter(Mandatory = $false)]
        [string[]]$ComputerName,
        [Parameter(Mandatory = $false)]
        [string[]]$AccountName,
        [Parameter(Mandatory = $false)]
        [PSCredential]$Credential
    )
    begin
    {
        if (!$ComputerName -and !$AccountName)
        {
            $ComputerName = "localhost"
            $AccountName = "$env:USERDOMAIN\$env:USERNAME"
        }
    }
    process
    {
        ForEach ($account in $AccountName)
        {
            $ogaccount = $account
            if ($account -like "*\*") {
                Write-Verbose "Account name ($account) provided in in domain\user format, stripping out domain info..."
                $account = ($account.split("\"))[1]
            }
            if ($account -like "*@*") {
                Write-Verbose "Account name ($account) provided in in user@domain format, stripping out domain info..."
                $account = ($account.split("@"))[0]
            }
            
            $root = ([ADSI]"LDAP://RootDSE").defaultNamingContext
            $adsearch = New-Object System.DirectoryServices.DirectorySearcher
            
            if ($Credential)
            {
                $domain = New-Object System.DirectoryServices.DirectoryEntry -ArgumentList ("LDAP://" + $root), $($Credential.UserName), $($Credential.GetNetworkCredential().password)
            }
            else
            {
                $domain = New-Object System.DirectoryServices.DirectoryEntry -ArgumentList ("LDAP://" + $root)
            }
            
            $adsearch.SearchRoot = $domain
            $adsearch.Filter = $("(&(samAccountName={0}))" -f $account)
            
            Write-Verbose "Looking for account $account..."
            $Result = $adsearch.FindOne()
            
            foreach ($spn in $result.Properties.serviceprincipalname) {
                [pscustomobject] @{
                    Name = $ogaccount
                    SPN = $spn
                }
            }
        }
        
        foreach ($server in $ComputerName)
        {
            Write-Verbose "Getting SQL Server SPN for $server"
            $spns = Test-DbaSpn -ComputerName $server -Credential $Credential
            
            Write-Verbose "Found $spns"
            foreach ($spn in $spns | Where-Object {$_.IsSet -eq $true}) {
                [pscustomobject] @{
                    Name = $server
                    SPN = $spn.RequiredSPN
                }
            }
        }
    }
}