Get-EntraBetaDirectorySetting

Módulo:
Microsoft.Entra.Beta.DirectoryManagement Module v1.3

Obtém uma configuração de diretório.

Sintaxe

GetQuery (Default) 

Get-EntraBetaDirectorySetting

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

GetById 

Get-EntraBetaDirectorySetting

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

Description

O Get-EntraBetaDirectorySetting cmdlet obtém uma configuração de diretório de Microsoft Entra ID. Especifique Id o parâmetro para obter uma configuração de diretório.

Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função de Microsoft Entra suportada ou uma função personalizada com uma permissão de função suportada. Há suporte para as seguintes funções menos privilegiadas:

  • Microsoft Entra Administrador Local do Dispositivo Ingressado (leia as propriedades básicas sobre como definir modelos e configurações)
  • Leitores de diretório (leia as propriedades básicas sobre como definir modelos e configurações)
  • Leitor Global (Ler propriedades básicas sobre como definir modelos e configurações)
  • Administrador de grupos (Gerenciar todas as configurações de grupo)
  • Gravadores de Diretório (Gerenciar todas as configurações de grupo)
  • Administrador de política de autenticação (atualizar configurações de regra de senha)
  • Administrador de usuário (ler propriedades básicas sobre como definir modelos e configurações)

Exemplos

Exemplo 1: Obter uma configuração de diretório

Connect-Entra -Scopes 'Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All'
Get-EntraBetaDirectorySetting -Id 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb'

Id                                   DisplayName            TemplateId
--                                   -----------            ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Application            00001111-aaaa-2222-bbbb-3333cccc4444

Este exemplo obtém uma configuração de diretório.

  • -Id o parâmetro especifica a ID de um diretório.

Exemplo 2: Obter todas as configurações de diretório

Connect-Entra -Scopes 'Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All'
Get-EntraBetaDirectorySetting -All

Id                                   DisplayName            TemplateId
--                                   -----------            ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Application            00001111-aaaa-2222-bbbb-3333cccc4444
bbbbbbbb-1111-2222-3333-cccccccccccc Password Rule Settings 11112222-bbbb-3333-cccc-4444dddd5555

Este exemplo obtém todas as configurações de diretório.

Exemplo 3: Obter a configuração de diretório n superior

Connect-Entra -Scopes 'Directory.ReadWrite.All, Group.Read.All, Group.ReadWrite.All'
Get-EntraBetaDirectorySetting -Top 2

Id                                   DisplayName            TemplateId
--                                   -----------            ----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb Application            00001111-aaaa-2222-bbbb-3333cccc4444
bbbbbbbb-1111-2222-3333-cccccccccccc Password Rule Settings 11112222-bbbb-3333-cccc-4444dddd5555

Este exemplo obtém as duas principais configurações de diretório. Você pode usar -Limit como um alias para -Top.

Parâmetros

-All

Listar todas as páginas.

Propriedades do parâmetro

Tipo:System.Management.Automation.SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

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

-Id

Especifica a ID de um diretório em 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

-Top

Especifica o número máximo de registros a serem retornados.

Propriedades do parâmetro

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

Conjuntos de parâmetros

GetQuery
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
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.