Get-EntraNamedLocationPolicy

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

Recebe uma política de localização com nome do Microsoft Entra ID.

Sintaxe

GetQuery (Predefinição) 

Get-EntraNamedLocationPolicy

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

GetById 

Get-EntraNamedLocationPolicy

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

Descrição

Este cmdlet permite a um administrador obter as políticas de localização nomeadas do Microsoft Entra ID.

As localizações nomeadas são regras personalizadas que definem localizações de rede, que podem depois ser usadas numa política de Acesso Condicional.

Em cenários delegados com contas de trabalho ou escola, ao atuar sobre outro utilizador, o utilizador iniciado deve ter um papel Microsoft Entra suportado ou um papel personalizado com as permissões necessárias. Os papéis menos privilegiados para esta operação são:

  • Global Secure Access Administrator (propriedades padrão apenas de leitura)
  • Leitor de Segurança (propriedades padrão apenas de leitura)
  • Administrador de Segurança (propriedades padrão apenas de leitura)
  • Leitor Global
  • Administrador de Acesso Condicional

Exemplos

Exemplo 1: Recupera uma lista de todas as políticas de localização nomeadas no 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 uma lista de todas as políticas de localização nomeadas no Microsoft Entra ID.

Exemplo 2: Recupera uma política de localização nomeada por Id

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

Este exemplo recupera uma política de localização nomeada especificada no Microsoft Entra ID.

  • -PolicyId parâmetro especifica o Id da política de uma política de localização nomeada.

Parâmetros

-PolicyId

Especifica o ID de uma política de localização nomeada no Microsoft Entra ID.

Propriedades dos parâmetros

Tipo:System.String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

GetById
Posto:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Property

Especifica propriedades a devolver.

Propriedades dos parâmetros

Tipo:

System.String[]

Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Select

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.