Get-EntraNamedLocationPolicy

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

Obtém um Microsoft Entra ID política de localização nomeada.

Sintaxe

GetQuery (Default) 

Get-EntraNamedLocationPolicy

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

GetById 

Get-EntraNamedLocationPolicy

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

Description

Esse cmdlet permite que um administrador obtenha o Microsoft Entra ID políticas de localização nomeadas.

Locais nomeados são regras personalizadas que definem locais de rede, que podem ser usados em uma política de Acesso Condicional.

Em cenários delegados com contas corporativas ou de estudante, ao agir em outro usuário, o usuário conectado deve ter suporte Microsoft Entra função ou função personalizada com as permissões necessárias. As funções com privilégios mínimos para esta operação são:

  • Administrador global de acesso seguro (propriedades padrão somente leitura)
  • Leitor de Segurança (propriedades padrão somente leitura)
  • Administrador de segurança (propriedades padrão somente 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

Esse comando recupera uma lista de todas as políticas de localização nomeadas no Microsoft Entra ID.

Exemplo 2: recupera uma política de local 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 local nomeada especificada em Microsoft Entra ID.

  • -PolicyId o parâmetro especifica a ID da política de uma política de local nomeada.

Parâmetros

-PolicyId

Especifica a ID de uma política de local nomeada no Microsoft Entra ID.

Propriedades do parâmetro

Tipo:System.String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

GetById
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Property

Especifica as propriedades a serem retornadas.

Propriedades do parâmetro

Tipo:

System.String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Select

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.