Get-EntraTenantDetail

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

Obtém os detalhes de um inquilino.

Sintaxe

Default (Predefinição) 

Get-EntraTenantDetail

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

Descrição

O Get-EntraTenantDetail cmdlet obtém os detalhes de um inquilino no Microsoft Entra ID.

Em cenários delegados envolvendo contas de trabalho ou escola, o utilizador iniciado deve ser atribuído a um papel Microsoft Entra suportado ou a um papel personalizado com as permissões necessárias. Os seguintes papéis de menor privilégio são suportados para esta operação:

  • Administrador de Aplicações
  • Administrador de Autenticação
  • Administrador de aplicativos na nuvem
  • Leitores de Diretório
  • Revisor de Diretórios
  • Leitor Global
  • Administrador do Helpdesk
  • Administrador de Segurança
  • Operador de Segurança
  • Leitor de cartões de segurança
  • Administrador de Suporte de Serviços
  • Administrador de usuários
  • Administrador de Função Privilegiada

Exemplos

Exemplo 1: Obtenha todos os detalhes do inquilino

Connect-Entra -Scopes 'Organization.Read.All'
Get-EntraTenantDetail -All

DisplayName Id                                   TenantType CountryLetterCode VerifiedDomains
----------- --                                   ---------- ----------------- ---------------
Contoso     aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb AAD        NL                {@{Capabilities=Email, OfficeCommunicationsOnline; IsDefault=False; IsInitial=True; Name=contoso.onmicrosoft.com; Type=Mana...

Este exemplo mostra como recuperar todos os dados do inquilino.

Exemplo 2: Obtenha todas as licenças no inquilino

Connect-Entra -Scopes 'Organization.Read.All'
Get-EntraTenantDetail | Select-Object -ExpandProperty ProvisionedPlans

CapabilityStatus ProvisioningStatus Service                       AdditionalProperties
---------------- ------------------ -------                       --------------------
Enabled          Success            SharePoint
Enabled          Success            exchange
Enabled          Success            exchange
Enabled          Success            exchange
Enabled          Success            SCO
Enabled          Success            exchange
Enabled          Success            SharePoint
Enabled          Success            CloudPC-MX
Enabled          Success            YammerEnterprise

Este exemplo mostra como recuperar todas as licenças do inquilino.

Exemplo 3: Obtenha os detalhes dos principais inquilinos

Connect-Entra -Scopes 'Organization.Read.All'
Get-EntraTenantDetail -Top 1

DisplayName Id                                   CountryLetterCode VerifiedDomains
----------- --                                   ----------------- ---------------
Contoso     aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb NL                {@{Capabilities=Email, OfficeCommunicationsOnline; IsDefault=False; IsInitial=True; Name=contoso.onmicrosoft.com; Type=Managed; Addition…}}

Este exemplo mostra como recuperar detalhes de um dos principais inquilinos no Microsoft Entra ID. Você pode usar -Limit como um alias para -Top.

Exemplo 4: Obter a quota de tamanho de inquilinos de diretório

Connect-Entra -Scopes 'Organization.Read.All'
(Get-EntraTenantDetail).AdditionalProperties.directorySizeQuota

Key   Value
---   -----
used    339
total 50000

Este exemplo mostra como recuperar a quota de tamanho de inquilino do diretório.

Uma quota de diretório representa o número máximo de objetos permitidos num inquilino, incluindo contas de utilizador, registos de aplicações e grupos. Uma vez atingido este limite, as tentativas de criar novos objetos resultarão num erro.

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

-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

-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

(All)
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.