Set-EntraUserSponsor

Modul:
Microsoft.Entra.Users Module v1.3

Legt die Sponsoren eines Benutzers fest (Benutzer oder Gruppen).

Syntax

SetUserSponsor (Standard) 

Set-EntraUserSponsor

    -UserId <String>
    -Type <String>
    -SponsorIds <String[]>
    [<CommonParameters>]

Beschreibung

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

Update-EntraUserSponsor ist ein Alias für Set-EntraUserSponsor.

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss der angemeldete Benutzer über eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle verfügen, die die microsoft.directory/users/sponsors/update Berechtigung enthält.

Die folgenden am wenigsten privilegierten Rollen unterstützen diesen Vorgang:

  • Verzeichnisautoren
  • Benutzeradministrator

Beispiele

Beispiel 1: Zuweisen eines Sponsors für einzelne Benutzer

Connect-Entra -Scopes 'User.ReadWrite.All'
$sponsor = Get-EntraUser -UserId 'SponsorEmail@contoso.com'
Set-EntraUserSponsor -UserId 'JohnstoneH@fabrikam.com' -Type User -SponsorIds $sponsor.Id

In diesem Beispiel wird veranschaulicht, wie ein einzelner Benutzer als Sponsor einem Zielbenutzerkonto zugewiesen wird.

  • Der -UserId Parameter gibt die Benutzer-ID oder den Benutzerprinzipalnamen an. Sie können -UserPrincipalName, -Identity, -UPNals -ObjectId Alias für -UserId.
  • Der -Type Parameter gibt den Typ des Sponsors an, der dem Benutzer zugewiesen wird. Unterstützte Sponsortypen sind (Benutzer oder Gruppe).
  • Der -SponsorIds Parameter gibt die ID der Sponsoren an, die dem Benutzer zugewiesen werden sollen.

Beispiel 2: Zuweisen eines Sponsors für einzelne Gruppen

Connect-Entra -Scopes 'User.ReadWrite.All', 'GroupMember.Read.All'
$group = Get-EntraGroup -SearchString 'Sales and Marketing'
Set-EntraUserSponsor -UserId 'JohnstoneH@fabrikam.com' -Type Group -SponsorIds $group.Id

In diesem Beispiel wird veranschaulicht, wie Sie eine einzelne Gruppe als Sponsor einem Zielbenutzerkonto zuweisen.

  • Der -UserId Parameter gibt die Benutzer-ID oder den Benutzerprinzipalnamen an. Sie können -UserPrincipalName, -Identity, -UPNals -ObjectId Alias für -UserId.
  • Der -Type Parameter gibt den Typ des Sponsors an, der dem Benutzer zugewiesen wird. Unterstützte Sponsortypen sind (Benutzer oder Gruppe).
  • Der -SponsorIds Parameter gibt die ID der Sponsoren an, die dem Benutzer zugewiesen werden sollen.

Beispiel 3: Zuweisen mehrerer Benutzersponsoren

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraUserSponsor -UserId 'JohnstoneH@fabrikam.com' -Type User -SponsorIds @("db0c6l50-93ee-4b22-9bb9-c8454875d990","c9db38b9-e5b8-4b5e-ak78-9812230af58d")

In diesem Beispiel wird veranschaulicht, wie Mehrere Benutzer als Sponsoren einem Zielbenutzerkonto zugewiesen werden.

  • Der -UserId Parameter gibt die Benutzer-ID oder den Benutzerprinzipalnamen an. Sie können -UserPrincipalName, -Identity, -UPNals -ObjectId Alias für -UserId.
  • Der -Type Parameter gibt den Typ des Sponsors an, der dem Benutzer zugewiesen wird. Unterstützte Sponsortypen sind (Benutzer oder Gruppe).
  • Der -SponsorIds Parameter gibt die ID der Sponsoren an, die dem Benutzer zugewiesen werden sollen.

Beispiel 4: Zuweisen mehrerer Gruppensponsoren

Connect-Entra -Scopes 'User.ReadWrite.All'
Set-EntraUserSponsor -UserId 'JohnstoneH@fabrikam.com' -Type Group -SponsorIds @("db0c6f50-93ee-4b22-9bb9-c8454875d990","c9db38b9-e5v8-4b5e-ae78-9812230af58d")

In diesem Beispiel wird veranschaulicht, wie sie einem Zielbenutzerkonto mehrere Gruppen als Sponsoren zuweisen.

  • Der -UserId Parameter gibt die Benutzer-ID oder den Benutzerprinzipalnamen an. Sie können -UserPrincipalName, -Identity, -UPNals -ObjectId Alias für -UserId.
  • Der -Type Parameter gibt den Typ des Sponsors an, der dem Benutzer zugewiesen wird. Unterstützte Sponsortypen sind (Benutzer oder Gruppe).
  • Der -SponsorIds Parameter gibt die ID der Sponsoren an, die dem Benutzer zugewiesen werden sollen.

Parameter

-SponsorId

Gibt die Sponsor-ID (Benutzer- oder Gruppen-ID) an, die dem jeweiligen Benutzerziel zugewiesen werden soll.

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

-Type

Gibt den Typ der Sponsoren an, die dem Benutzer zugewiesen werden. Unterstützte Sponsortypen sind (Benutzer oder Gruppe).

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

-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.