Get-EntraConditionalAccessPolicy

Module:
Microsoft.Entra.SignIns Module v1.3

Obtient une stratégie d’accès conditionnel Microsoft Entra ID.

Syntaxe

GetQuery (Par défaut) 

Get-EntraConditionalAccessPolicy

    [-Property <String[]>]
    [<CommonParameters>]

GetById 

Get-EntraConditionalAccessPolicy

    -PolicyId <String>
    [-Property <String[]>]
    [<CommonParameters>]

Description

Cette applet de commande permet à un administrateur d’obtenir la stratégie d’accès conditionnel Microsoft Entra ID. Les stratégies d’accès conditionnel sont des règles personnalisées qui définissent un scénario d’accès.

Dans les scénarios délégués impliquant des comptes professionnels ou scolaires, l’utilisateur connecté doit avoir un rôle Microsoft Entra ou un rôle personnalisé avec les autorisations requises pour agir au nom d’un autre utilisateur. Les rôles les moins privilégiés suivants prennent en charge cette opération :

  • Administrateur d’accès sécurisé global (propriétés standard en lecture)
  • Lecteur de sécurité (lire les propriétés standard)
  • Administrateur de sécurité (lire les propriétés standard)
  • Lecteur global
  • Administrateur de l’accès conditionnel

Dans les scénarios délégués impliquant des comptes professionnels ou scolaires, l’utilisateur connecté doit avoir un rôle Microsoft Entra ou un rôle personnalisé avec les autorisations requises pour agir au nom d’un autre utilisateur. Les rôles les moins privilégiés suivants prennent en charge cette opération :

  • Administrateur d’accès sécurisé global (propriétés standard en lecture)
  • Lecteur de sécurité (lire les propriétés standard)
  • Administrateur de sécurité (lire les propriétés standard)
  • Lecteur global
  • Administrateur de l’accès conditionnel

Exemples

Exemple 1 : Récupère une liste de toutes les stratégies d’accès conditionnel dans Microsoft Entra ID

Connect-Entra -Scopes 'Policy.Read.All'
Get-EntraConditionalAccessPolicy

Id                                   CreatedDateTime      Description DisplayName                ModifiedDateTime     State    TemplateId
--                                   ---------------      ----------- -----------                ----------------     -----    ----------
eeeeeeee-4444-5555-6666-ffffffffffff 2/27/2024 6:23:21 AM             ConditionalAccessPolicy    2/29/2024 2:41:17 PM disabled
ffffffff-5555-6666-7777-aaaaaaaaaaaa 2/27/2024 6:26:00 AM             ConditionalAccessPolicy    2/29/2024 2:41:34 PM disabled
aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb 2/27/2024 6:30:48 AM             ConditionalAccessPolicy    2/29/2024 2:43:53 PM disabled

Cet exemple récupère une liste de toutes les stratégies d’accès conditionnel dans Microsoft Entra ID.

Exemple 2 : Récupère une stratégie d’accès conditionnel dans Microsoft Entra ID avec l’ID donné

Connect-Entra -Scopes 'Policy.Read.All'
$policy = Get-EntraConditionalAccessPolicy | Where-Object { $_.DisplayName -eq 'Multifactor authentication for Contoso partners and vendors' }
Get-EntraConditionalAccessPolicy -PolicyId $policy.Id

Id                                    CreatedDateTime        Description                  DisplayName                  ModifiedDateTime       State     TemplateId
--                                    ---------------        -----------                  -----------                  ----------------       -----     ----------
eeeeeeee-4444-5555-6666-ffffffffffff  2/27/2024 6:23:21 AM   Multifactor authentication   2/29/2024 2:41:17 PM         disabled

Cet exemple récupère une stratégie d’accès conditionnel spécifiée dans Microsoft Entra ID.

  • -PolicyId spécifie l’ID d’une stratégie d’accès conditionnel.

Paramètres

-PolicyId

Spécifie l’ID d’une stratégie d’accès conditionnel dans Microsoft Entra ID.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

GetById
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Property

Spécifie les propriétés à retourner.

Propriétés du paramètre

Type:

System.String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Sélectionnez

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.