Get-EntraBetaPolicy

Modulo:
Microsoft.Entra.Beta.SignIns Module v1.3

Ottiene un criterio.

Sintassi

GetQuery (Impostazione predefinita) 

Get-EntraBetaPolicy

    [-Top <Int32>]
    [-All]
    [<CommonParameters>]

GetById 

Get-EntraBetaPolicy

    -Id <String>
    [-All]
    [<CommonParameters>]

Descrizione

Il Get-EntraBetaPolicy cmdlet ottiene un criterio in Microsoft Entra ID. Specificare il Id parametro per ottenere un criterio specifico.

Esempio

Esempio 1: Ottenere tutti i criteri

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

Definition                                                                                       DeletedDateTime Description DisplayName                                 Id
----------                                                                                       --------------- ----------- -----------                                 --
{{"activityBasedTimeoutPolicies":{"AlternateLoginIDLookup":true, "IncludedUserIds":["UserID"]}}}                             Activepolicy                            bbbbbbbb-1111-2222-3333-cccccccccccc
{{"HomeRealmDiscoveryPolicy":{"AlternateLoginIDLookup":true, "IncludedUserIds":["UserID"]}}}                                 PolicyDemo                              aaaaaaaa-1111-1111-1111-000000000000

In questo esempio viene illustrato come restituire tutti i criteri.

Esempio 2: Ottenere criteri con il nome visualizzato

Connect-Entra -Scopes 'Policy.Read.All'
Get-EntraBetaPolicy | Where-Object {$_.DisplayName -eq 'Microsoft User Default Recommended Policy'}

DeletedDateTime Description                                                           DisplayName                               Id
--------------- -----------                                                           -----------                               --
                Permissions consentable based on Microsoft's current recommendations. Microsoft User Default Recommended Policy microsoft-user-default-recommended

In questo esempio viene illustrato come ottenere un criterio specifico usando nome visualizzato.

Esempio 3: Ottenere un criterio con ID specifico

Connect-Entra -Scopes 'Policy.Read.All'
$policy = Get-EntraBetaPolicy | Where-Object {$_.DisplayName -eq 'Microsoft User Default Recommended Policy'}
Get-EntraBetaPolicy -Id $policy.Id

Id                                   Description                     DisplayName                     Feature          IsAppliedToOrganization IsEnabled
--                                   -----------                     -----------                     -------          ----------------------- ---------
bbbbbbbb-1111-2222-3333-cccccccccccc passwordHashSync rollout policy passwordHashSync rollout policy passwordHashSync False                   True

Questo esempio ha illustrato come ricevere criteri con ID specifico.

  • Id parametro specifica l'ID criterio univoco che si desidera ricevere. In questo esempio rappresenta bbbbbbbb-1111-2222-3333-cccccccccccc l'ID del criterio.

Esempio 4: Ottenere tutti i criteri

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

Definition                                                                                       DeletedDateTime Description DisplayName                                 Id
----------                                                                                       --------------- ----------- -----------                                 --
{{"activityBasedTimeoutPolicies":{"AlternateLoginIDLookup":true, "IncludedUserIds":["UserID"]}}}                             Activepolicy                            bbbbbbbb-1111-2222-3333-cccccccccccc
{{"HomeRealmDiscoveryPolicy":{"AlternateLoginIDLookup":true, "IncludedUserIds":["UserID"]}}}                                 PolicyDemo                              aaaaaaaa-1111-1111-1111-000000000000

In questo esempio viene illustrato come recuperare tutti i criteri in Microsoft Entra ID.

Esempio 5: Ottenere i primi criteri

Connect-Entra -Scopes 'Policy.Read.All'
Get-EntraBetaPolicy -Top 1

Id                                   Description                     DisplayName                     Feature          IsAppliedToOrganization IsEnabled
--                                   -----------                     -----------                     -------          ----------------------- ---------
bbbbbbbb-1111-2222-3333-cccccccccccc passwordHashSync rollout policy passwordHashSync rollout policy passwordHashSync False                   True

In questo esempio viene illustrato come recuperare i primi criteri in Microsoft Entra ID. È possibile usare -Limit come alias per -Top.

Parametri

-All

Elencare tutti i criteri.

Proprietà dei parametri

Tipo:System.Management.Automation.SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Id

ID del criterio da recuperare.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

GetById
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Top

Specifica il numero massimo di record da restituire.

Proprietà dei parametri

Tipo:System.Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Limit

Set di parametri

GetQuery
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.