Get-EntraUserLicenseDetail
Recupera os detalhes da licença de um usuário.
Sintaxe
Default (Default)
Get-EntraUserLicenseDetail
-UserId <String>
[-Property <String[]>]
[<CommonParameters>]
Description
Esse cmdlet recupera os detalhes da licença de um usuário.
Em cenários delegados com contas corporativas ou de estudante, o usuário conectado precisa de uma função de Microsoft Entra com suporte ou uma função personalizada com a microsoft.directory/users/licenseDetails/read permissão. As seguintes funções com privilégios mínimos dão suporte a esta operação:
- Convidador
- Leitores de diretório
- Gravadores de diretório
- Administrador de Licenças
- Administrador de usuários
Em cenários delegados com contas corporativas ou de estudante, o usuário conectado precisa de uma função de Microsoft Entra com suporte ou uma função personalizada com a microsoft.directory/users/licenseDetails/read permissão. As seguintes funções com privilégios mínimos dão suporte a esta operação:
- Convidador
- Leitores de diretório
- Gravadores de diretório
- Administrador de Licenças
- Administrador de usuários
Exemplos
Exemplo 1: recuperar detalhes da licença do usuário
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserLicenseDetail -UserId 'SawyerM@contoso.com'
Id SkuId SkuPartNumber
-- ----- -------------
X8Wu1RItQkSNL8zKldQ5DiH6ThjDmF1OlavQcFOpbmc aaaaaaaa-0b0b-1c1c-2d2d-333333333333 INFORMATION_PROTECTION_COMPLIANCE
X8Wu1RItQkSNL8zKldQ5Dk8SXrDMx6BFpqqM94yUaWg bbbbbbbb-1c1c-2d2d-3e3e-444444444444 EMSPREMIUM
X8Wu1RItQkSNL8zKldQ5DmAn38eBLPdOtXhbU5K1cd8 cccccccc-2d2d-3e3e-4f4f-555555555555 ENTERPRISEPREMIUM
Este exemplo demonstra como recuperar detalhes de licença para um usuário de Microsoft Entra ID.
Parâmetros
-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 |
-UserId
A ID do objeto do usuário para o qual os detalhes da licença são recuperados. Especifica a ID de UserPrincipalName ou UserId de um usuário no Microsoft Entra ID.
Propriedades do parâmetro
| Tipo: | System.String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | IdentificadorDeObjeto, UPN, Identidade, Nome Principal do Usuário |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| 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.