Public/Get-BadgeOwner.ps1
|
<#
.SYNOPSIS Gets a badge owner. .DESCRIPTION Gets the owner of a badge. If the result returns null, try the parameter "-Verbose" to get more details. .EXAMPLE Get-BadgeOwner .LINK https://github.com/erwindevreugd/PSDataConduIT .EXTERNALHELP PSDataConduIT-help.xml #> function Get-BadgeOwner { [CmdletBinding()] param ( [Parameter( Position = 0, Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'The name of the server where the DataConduIT service is running or localhost.')] [string] $Server = $Script:Server, [Parameter( Position = 1, Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'The credentials used to authenticate the user to the DataConduIT service.')] [PSCredential] $Credential = $Script:Credential, [Parameter( Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'Specifies the badge id for which to get the badge owner.')] [long] $BadgeID, [Parameter( Mandatory = $false, ValueFromPipelineByPropertyName = $true, HelpMessage = 'Specifies the badge key for which to get the badge owner.')] [int] $BadgeKey ) process { $query = "SELECT * FROM Lnl_Badge WHERE __CLASS='Lnl_Badge'" if ($BadgeID) { $query += " AND ID=$BadgeID" } if ($BadgeKey) { $query += " AND BADGEKEY=$BadgeKey" } LogQuery $query $parameters = @{ ComputerName = $Server; Namespace = $Script:OnGuardNamespace; Query = $query } if ($Credential -ne $null) { $parameters.Add("Credential", $Credential) } Get-WmiObject @parameters | ForEach-Object { New-Object PSObject -Property @{ Class = $_.__CLASS; SuperClass = $_.__SUPERCLASS; Server = $_.__SERVER; ComputerName = $_.__SERVER; Path = $_.__PATH; Credential = $Credential; PersonID = $_.PERSONID; } | Get-Person } } } |