Get-EntraUserSponsor

Modul:
Microsoft.Entra.Users Module v1.3

Abrufen der Sponsoren eines Benutzers (Benutzer oder Gruppen).

Syntax

GetQuery 

Get-EntraUserSponsor

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

GetById 

Get-EntraUserSponsor

    -UserId <String>
    -SponsorId <String>
    [-All]
    [-Property <String[]>]
    [<CommonParameters>]

Beschreibung

Das Get-EntraUserSponsor Cmdlet ruft die Sponsoren eines Benutzers (Benutzer oder Gruppen) ab. Das Sponsorfeature verfolgt, wer für jeden Gastbenutzer verantwortlich ist, indem er eine Person oder Gruppe zuweist, um die Verantwortlichkeit sicherzustellen.

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten benötigt der angemeldete Benutzer eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit microsoft.directory/users/sponsors/read permission. Die am wenigsten privilegierten unterstützten Rollen sind:

  • Gasteinladender
  • Verzeichnisleser
  • Verzeichnisautoren
  • Benutzeradministrator

Beispiele

Beispiel 1: Abrufen der Benutzersponsoren

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

In diesem Beispiel wird gezeigt, wie Benutzersponsoren aufgeführt werden.

  • Der -UserId Parameter gibt die Benutzer-ID oder den Benutzerprinzipalnamen an.

Beispiel 2: Abrufen eines Sponsors

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

In diesem Beispiel wird der oberste Sponsor für den angegebenen Benutzer abgerufen. Sie können -Limit als Alias für -Top verwenden.

  • Der -UserId Parameter gibt die Benutzer-ID oder den Benutzerprinzipalnamen an.

Beispiel 3: Abrufen des zugewiesenen Sponsors für einen bestimmten Benutzer durch seine 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

In diesem Beispiel wird der zugewiesene Sponsor für den angegebenen Benutzer abgerufen.

  • Der -UserId Parameter gibt die Benutzer-ID oder den Benutzerprinzipalnamen an.
  • Der -SponsorId Parameter gibt die sponsor-ID des bestimmten Benutzers an, die abgerufen werden soll (Benutzer- oder Gruppen-ID).

Parameter

-All

Alle Seiten auflisten.

Parametereigenschaften

Typ:System.Management.Automation.SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Filter

Gibt eine OData v4.0-Filter-Anweisung an. Dieser Parameter steuert, welche Objekte zurückgegeben werden.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetQuery
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Property

Gibt eigenschaften an, die zurückgegeben werden sollen.

Parametereigenschaften

Typ:

System.String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Select

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SponsorId

Gibt die sponsor-ID des bestimmten Benutzers an, die abgerufen werden soll (Benutzer- oder Gruppen-ID).

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Top

Gibt die maximale Anzahl der zurückzugebenden Datensätze an.

Parametereigenschaften

Typ:System.Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Begrenzung

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-UserId

Gibt die ID (als UserPrincipalName oder UserId) eines Benutzers in Microsoft Entra ID an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Objekt-ID, UPN (Benutzerprinzipalname), Identity, Benutzerhauptname

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.