Get-EntraUserSponsor
Recuperar os patrocinadores de um utilizador (utilizadores ou grupos).
Sintaxe
GetQuery
Get-EntraUserSponsor
-UserId <String>
[-All]
[-Filter <String>]
[-Top <Int32>]
[-Property <String[]>]
[<CommonParameters>]
GetById
Get-EntraUserSponsor
-UserId <String>
-SponsorId <String>
[-All]
[-Property <String[]>]
[<CommonParameters>]
Descrição
O Get-EntraUserSponsor cmdlet recupera os patrocinadores do utilizador (utilizadores ou grupos). A funcionalidade de patrocinador acompanha quem é responsável por cada utilizador convidado, atribuindo uma pessoa ou grupo, garantindo a responsabilização.
Em cenários delegados com contas de trabalho ou escola, o utilizador com sessão registada precisa de um papel Microsoft Entra suportado ou de um papel personalizado com microsoft.directory/users/sponsors/read permission. Os papéis apoiados menos privilegiados são:
- Convite de Convidados
- Leitores de Diretório
- Escritores de Diretórios
- Administrador de usuários
Exemplos
Exemplo 1: Arranja patrocinadores para os utilizadores
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserSponsor -UserId 'SawyerM@contoso.com' -All |
Select-Object Id, DisplayName, '@odata.type', CreatedDateTime | Format-Table -AutoSize
id displayName @odata.type createdDateTime
-- ----------- ----------- ---------------
cccccccc-2222-3333-4444-dddddddddddd Angel Brown(Fabrikam) #microsoft.graph.user 3/7/2024 3:10:31 AM
eeeeeeee-4444-5555-6666-ffffffffffff Fabrikam Helpdesk Group #microsoft.graph.group 8/7/2024 2:52:47 PM
Este exemplo mostra como listar patrocinadores utilizadores.
- O
-UserIdparâmetro especifica o ID do Utilizador ou Nome Principal do Utilizador.
Exemplo 2: Obtenha o melhor patrocinador
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserSponsor -UserId 'SawyerM@contoso.com' -Top 1 |
Select-Object Id, DisplayName, '@odata.type', CreatedDateTime | Format-Table -AutoSize
id displayName @odata.type createdDateTime
-- ----------- ----------- ---------------
cccccccc-2222-3333-4444-dddddddddddd Angel Brown(Fabrikam) #microsoft.graph.user 3/7/2024 3:10:31 AM
Este exemplo recupera o principal patrocinador para o utilizador especificado. Você pode usar -Limit como um alias para -Top.
- O
-UserIdparâmetro especifica o ID do Utilizador ou Nome Principal do Utilizador.
Exemplo 3: Recuperar o patrocinador atribuído a um utilizador específico através do seu SponsorId
Connect-Entra -Scopes 'User.Read.All'
Get-EntraUserSponsor -UserId 'SawyerM@contoso.com' -SponsorId 'cccccccc-2222-3333-4444-dddddddddddd' |
Select-Object Id, DisplayName, '@odata.type', CreatedDateTime | Format-Table -AutoSize
id displayName @odata.type createdDateTime
-- ----------- ----------- ---------------
cccccccc-2222-3333-4444-dddddddddddd Angel Brown(Fabrikam) #microsoft.graph.user 3/7/2024 3:10:31 AM
eeeeeeee-4444-5555-6666-ffffffffffff Fabrikam Helpdesk Group #microsoft.graph.group 8/7/2024 2:52:47 PM
Este exemplo recupera o patrocinador atribuído para o utilizador especificado.
- O
-UserIdparâmetro especifica o ID do Utilizador ou Nome Principal do Utilizador. - O
-SponsorIdparâmetro especifica o ID de patrocinador específico do utilizador a recuperar (ID de utilizador ou grupo).
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 |
-Filter
Especifica uma instrução de filtro OData v4.0. Este parâmetro controla quais os objetos que são devolvidos.
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
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 |
-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 |
-SponsorId
Especifica o ID de patrocinador específico do utilizador a recuperar (ID de utilizador ou grupo).
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| 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 |
-UserId
Especifica o ID (como UserPrincipalName ou UserId) de um utilizador no Microsoft Entra ID.
Propriedades dos parâmetros
| Tipo: | System.String |
| Valor predefinido: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | IdentificadorDoObjeto, UPN, Identidade, Nome Principal do Utilizador |
Conjuntos de parâmetros
(All)
| Posto: | Named |
| Obrigatório: | True |
| 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.