Creates a new temporary object that holds information about a MicrosoftEntraId.

Syntax

New-RedgateMonitorMicrosoftEntraId -Name <string> -BaseMonitor <BaseMonitor> [-ServicePrincipalCredential <ServicePrincipalCredential>] [<CommonParameters>]
 

Description

The New-RedgateMonitorMicrosoftEntraId cmdlet creates a new temporary object that holds information about a MicrosoftEntraId. The returned object needs to be passed to Add-RedgateMonitorMonitoredIamObject, as it does not add anything to Redgate Monitor on its own.

Parameters

-Name <String>

The name of the monitored object e.g. "[azure-directory-name]".

-BaseMonitor <BaseMonitor>

The base monitor to add the monitored object to. For more information, see https://documentation.red-gate.com/monitor14/api/powershell-api/powershell-cmdlet-reference/get-redgatemonitorbasemonitor.

-ServicePrincipalCredential <ServicePrincipalCredential>

The Service Principal Credential to connect to Microsoft Graph API.

-ProgressAction <ActionPreference>

{{ Fill ProgressAction Description }}

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see http://technet.microsoft.com/en-us/library/hh847884.aspx.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

• None.
  You cannot pipe input to this cmdlet.

Examples

-------------------------- EXAMPLE 1 --------------------------

$entraID = New-RedgateMonitorMicrosoftEntraId -Name "testing" -BaseMonitor $BaseMonitor
$entraID | Add-RedgateMonitorMonitoredIamObject

-------------------------- EXAMPLE 2 --------------------------

$azureTenantCredential = Get-RedgateMonitorServicePrincipalCredential -Name "azureApp"
$entraID = New-RedgateMonitorMicrosoftEntraId -Name "testing" -BaseMonitor $BaseMonitor -ServicePrincipalCredential  $azureTenantCredential
$entraID | Add-RedgateMonitorMonitoredIamObject