netapi32/NetGetDCName.ps1
|
function NetGetDCName { <# .SYNOPSIS Returns the name of the primary domain controller (PDC). .DESCRIPTION This function will execute the NetGetDCName Win32API call to return a system's primary domain controller. .PARAMETER ComputerName Specifies the hostname to query the PDC for (also accepts IP addresses). .PARAMETER DomainName The domain the ComputerName resides in to enumerate the PDS for. .NOTES Author: Will Schroeder (@harmj0y) License: BSD 3-Clause Required Dependencies: PSReflect, NetApiBufferFree (Function) Optional Dependencies: None (func netapi32 NetGetDCName ([Int32]) @( [string], # _In_ LPCWSTR servername [string], # _In_ LPCWSTR domainname [IntPtr].MakeByRefType() # _Out_ LPBYTE *bufptr ) -EntryPoint NetGetDCName) .LINK https://msdn.microsoft.com/en-us/library/windows/desktop/aa370420(v=vs.85).aspx .EXAMPLE #> [CmdletBinding()] Param( [Parameter(Position = 0, ValueFromPipeline = $True, ValueFromPipelineByPropertyName = $True)] [Alias('HostName', 'dnshostname', 'name')] [String] $ComputerName, [Parameter(Position = 1, ValueFromPipelineByPropertyName = $True)] [Alias('domain')] [ValidateNotNullOrEmpty()] [String] $DomainName ) PROCESS { # if we get an IP address, try to resolve the IP to a hostname if ($Computer -match '^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$') { $Computer = [System.Net.Dns]::GetHostByAddress($Computer) | Select-Object -ExpandProperty HostName } else { $Computer = $ComputerName } $PtrInfo = [IntPtr]::Zero $Result = $Netapi32::NetGetDCName($Computer, $DomainName, [ref]$PtrInfo) if ($Result -eq 0) { [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($PtrInfo) } else { Throw "[NetGetDCName] Error enumerating site for '$Computer' : $(([ComponentModel.Win32Exception]$Result).Message)" } NetApiBufferFree -Buffer $PtrInfo } } |