added certificate param

Author: Theo Dumitrescu (from Dev Box)

src/Get-MsIdCBACertificateUserIdFromCertificate.ps1

@@ -1,3 +1,7 @@
+# ------------------------------------------------------------------------------
+#  Copyright (c) Microsoft Corporation.  All Rights Reserved.  Licensed under the MIT License.  See License in the project root for license information.
+# ------------------------------------------------------------------------------
+
 <#
 .SYNOPSIS
     Generates an object representing all the values contained in a certificate file that can be used in Entra ID for configuring CertificateUserIDs in Certificate-Based Authentication.
@@ -8,6 +12,9 @@
 .PARAMETER Path
     The path to the certificate file. The file can be in .cer or .pem format.
 
+.PARAMETER Certificate
+    An X509Certificate2 object
+
 .PARAMETER CertificateMapping
     The certificate mapping property to retrieve. Valid values are PrincipalName, RFC822Name, IssuerAndSubject, Subject, SKI, SHA1PublicKey, and IssuerAndSerialNumber.
 
@@ -16,6 +23,11 @@
 
     This command retrieves all the possible certificate mappings and returns an object to represent them.
 
+.EXAMPLE
+    PS > Get-MsIdCBACertificateUserIdFromCertificate -Certificate $cert
+
+    This command retrieves all the possible certificate mappings and returns an object to represent them.
+
 .EXAMPLE
     PS > Get-MsIdCBACertificateUserIdFromCertificate -Path "C:\path\to\certificate.cer" -CertificateMapping Subject
 
@@ -37,11 +49,12 @@
 #>
 
 function Get-MsIdCBACertificateUserIdFromCertificate {
-    [CmdletBinding(HelpUri = 'https://azuread.github.io/MSIdentityTools/commands/Get-MsIdCBACertificateUserIdFromCertificate')]
     param (
-        [Parameter(Mandatory = $true)]    
+        [Parameter(Mandatory = $false)]
         [string]$Path,
         [Parameter(Mandatory = $false)]
+        [System.Security.Cryptography.X509Certificates.X509Certificate2]$Certificate,
+        [Parameter(Mandatory = $false)]
         [ValidateSet("PrincipalName", "RFC822Name", "IssuerAndSubject", "Subject", "SKI", "SHA1PublicKey", "IssuerAndSerialNumber")]
         [string]$CertificateMapping
     )
@@ -191,7 +204,12 @@ function Get-MsIdCBACertificateUserIdFromCertificate {
 
     function Main
     {
-        $cert = Get-Certificate -filePath $Path
+        $cert = $Certificate
+        if ($null -eq $cert)
+        {
+            $cert = Get-Certificate -filePath $Path
+        }
+
         $mappings = Get-CertificateUserIds -cert $cert
 
         if ($CertificateMapping -eq "")

website/docs/commands/Get-MsIdCBACertificateUserIdFromCertificate.mdx

@@ -60,6 +60,9 @@ X509:<S>DC=com,DC=contoso,OU=UserAccounts,CN=mfatest
 
 Path to the certificate file, it can be either a cer or pem file.
 
+### -Certificate
+Certificate from which the certificateUserIDs mappings will be extracted
+
 ### -CertificateMapping
 One of the values `PrincipalName`, `RFC822Name`, `IssuerAndSubject`, `Subject`, `SKI`, `SHA1PublicKey`, and `IssuerAndSerialNumber`
 To filer