Public/Get-ALHADDSDomainController.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
120
121
122
123
124
125
126
127
128
<#PSScriptInfo
 
.VERSION 1.2.1
 
.GUID d94d4ef6-0227-4c9d-9dbd-4abd93464d29
 
.AUTHOR Dieter Koch
 
.COMPANYNAME
 
.COPYRIGHT (c) 2021-2023 Dieter Koch
 
.TAGS
 
.LICENSEURI https://github.com/admins-little-helper/ALH/blob/main/LICENSE
 
.PROJECTURI https://github.com/admins-little-helper/ALH
 
.ICONURI
 
.EXTERNALMODULEDEPENDENCIES
 
.REQUIREDSCRIPTS
 
.EXTERNALSCRIPTDEPENDENCIES
 
.RELEASENOTES
1.0.0
- Initial release
 
1.1.0
- Renamed function to Get-ALHDomainController because it does not query Active Directory itself
- Removed dependency for ActiveDirectory Module
 
1.2.0
- Cleaned up code
 
1.2.1
- Fixed issue #38. Using Get-CimInstance intead of Get-WmiObject to support PowerShell Core (v5.1+)
 
#>



<#
 
.DESCRIPTION
Contains function to get the currently used Domain Controller by the operating system.
 
#>



function Get-ALHADDSDomainController {
    <#
    .SYNOPSIS
    Returns information about AD Domain Controller.
 
    .DESCRIPTION
    Returns information about AD Domain Controller.
 
    .EXAMPLE
    Get-ALHADDSDomainController
 
    Get the current domain controller used by the operating system
 
    .EXAMPLE
    Get-ALHADDSDomainController -All
 
    Get the all domain controllers in the current domain
 
    .INPUTS
    Nothing
 
    .OUTPUTS
    System.DirectoryServices.ActiveDirectory.DirectoryServer
 
    .NOTES
    Author: Dieter Koch
    Email: diko@admins-little-helper.de
 
    .LINK
    https://github.com/admins-little-helper/ALH/blob/main/Help/Get-ALHADDSDomainController.txt
    #>


    [CmdletBinding()]
    param (
        [switch]
        $All
    )

    $Domain = (Get-CimInstance -ClassName "Win32_ComputerSystem").Domain

    if ($null -ne $Domain) {
        $context = New-Object System.DirectoryServices.ActiveDirectory.DirectoryContext("Domain", $Domain)

        if ($All.IsPresent) {
            $DC = [System.DirectoryServices.ActiveDirectory.DomainController]::FindAll($context)
        }
        else {
            $DC = [System.DirectoryServices.ActiveDirectory.DomainController]::FindOne($context)
        }
    }
    else {
        Write-Warning -Message "Computer is not connected to an AD Domain."
    }

    $DC
}


#region EndOfScript
<#
################################################################################
################################################################################
#
# ______ _ __ _____ _ _
# | ____| | | / _| / ____| (_) | |
# | |__ _ __ __| | ___ | |_ | (___ ___ _ __ _ _ __ | |_
# | __| | '_ \ / _` | / _ \| _| \___ \ / __| '__| | '_ \| __|
# | |____| | | | (_| | | (_) | | ____) | (__| | | | |_) | |_
# |______|_| |_|\__,_| \___/|_| |_____/ \___|_| |_| .__/ \__|
# | |
# |_|
################################################################################
################################################################################
# created with help of http://patorjk.com/software/taag/
#>

#endregion