Get-EntraNamedLocationPolicy

Módulo:
Microsoft.Entra.SignIns Module v1.3

Obtiene un Microsoft Entra ID directiva de ubicación con nombre.

Sintaxis

GetQuery (valor predeterminado) 

Get-EntraNamedLocationPolicy

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

GetById 

Get-EntraNamedLocationPolicy

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

Description

Este cmdlet permite a un administrador obtener la Microsoft Entra ID directivas de ubicación con nombre.

Las ubicaciones con nombre son reglas personalizadas que definen ubicaciones de red, que luego se pueden usar en una directiva de acceso condicional.

En escenarios delegados con cuentas profesionales o educativas, al actuar en otro usuario, el usuario que ha iniciado sesión debe tener un rol de Microsoft Entra compatible o un rol personalizado con los permisos necesarios. Los roles con privilegios mínimos para esta operación son:

  • Administrador de acceso seguro global (propiedades estándar de solo lectura)
  • Lector de seguridad (propiedades estándar de solo lectura)
  • Administrador de seguridad (propiedades estándar de solo lectura)
  • Lector universal
  • Administrador de acceso condicional

Ejemplos

Ejemplo 1: Recupera una lista de todas las directivas de ubicación con nombre en Microsoft Entra ID

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

Id                                   CreatedDateTime      DisplayName    ModifiedDateTime
--                                   ---------------      -----------    ----------------
dddddddd-3333-4444-5555-eeeeeeeeeeee 31/07/2024 9:53:10   NamedLocation   31/07/2024 9:53:10
eeeeeeee-4444-5555-6666-ffffffffffff 31/07/2024 4:38:42   NamedLocation1  31/07/2024 4:38:42
ffffffff-5555-6666-7777-aaaaaaaaaaaa 01/08/2024 4:39:42   NamedLocation2  01/08/2024 4:39:42
aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb 01/08/2024 4:57:03   NamedLocation3  01/08/2024 4:57:03

Este comando recupera una lista de todas las directivas de ubicación con nombre en Microsoft Entra ID.

Ejemplo 2: Recupera una directiva de ubicación con nombre por identificador

Connect-Entra -Scopes 'Policy.Read.All'
$policy = Get-EntraNamedLocationPolicy | Where-Object { $_.DisplayName -eq 'Provisioning Workers' }
Get-EntraNamedLocationPolicy -PolicyId $policy.Id

Id                                   CreatedDateTime      DisplayName    ModifiedDateTime
--                                   ---------------      -----------    ----------------
dddddddd-3333-4444-5555-eeeeeeeeeeee 3/1/2024 9:53:10 AM  NamedLocation  3/1/2024 9:53:10 AM

En este ejemplo se recupera una directiva de ubicación con nombre especificada en Microsoft Entra ID.

  • -PolicyId parameter especifica el identificador de directiva de una directiva de ubicación con nombre.

Parámetros

-PolicyId

Especifica el identificador de una directiva de ubicación con nombre en Microsoft Entra ID.

Propiedades de parámetro

Tipo:System.String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetById
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Property

Especifica las propiedades que se van a devolver.

Propiedades de parámetro

Tipo:

System.String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Select

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.