Get-EntraBetaDirectorySetting

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

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

Sintaxe

GetQuery (Predefinição) 

Get-EntraBetaDirectorySetting

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

GetById 

Get-EntraBetaDirectorySetting

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

Descrição

O Get-EntraBetaDirectorySetting cmdlet recebe uma definição de diretório do Microsoft Entra ID. Especifique Id um parâmetro para obter uma definição de diretório.

Em cenários delegados com contas de trabalho ou escola, o utilizador iniciado deve ser atribuído a um papel Microsoft Entra suportado ou a um papel personalizado com permissão de função suportada. São suportados os seguintes papéis menos privilegiados:

  • Microsoft Entra Administrador Local de Dispositivo Integrado (Leia as propriedades básicas dos modelos de definição e definições)
  • Leitores de Diretórios (Leiam propriedades básicas sobre modelos de definições e definições)
  • Global Reader (Leia propriedades básicas sobre templates e definições de definição)
  • Administrador de Grupos (Gerir todas as definições do grupo)
  • Directory Writers (Gerir todas as definições do grupo)
  • Administrador de Política de Autenticação (Atualizar Definições de Regra de Palavra-passe)
  • Administrador de Utilizador (Leia propriedades básicas sobre modelos de definições e definições)

Exemplos

Exemplo 1: Obter uma definiçã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 recebe uma definição de diretório.

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

Exemplo 2: Definição de diretórios para obter tudo

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 tem todas as definições de diretórios.

Exemplo 3: Obter a definição top n do diretório

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 tem a definição dos dois melhores diretórios. Você pode usar -Limit como um alias para -Top.

Parâmetros

-All

Liste todas as páginas.

Propriedades dos parâmetros

Tipo:System.Management.Automation.SwitchParameter
Valor predefinido:False
Suporta carateres universais:False
NãoMostrar:False

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

-Id

Especifica o ID de um diretório 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 serem devolvidas

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

-Top

Especifica o número máximo de registos a devolver.

Propriedades dos parâmetros

Tipo:System.Int32
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Limit

Conjuntos de parâmetros

GetQuery
Posto:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
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.