Set-EntraUserSponsor

Ustawia sponsorów użytkownika (użytkowników lub grup).

Składnia

SetUserSponsor (domyślnie)

Set-EntraUserSponsor

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

Opis

Polecenie Set-EntraUserSponsor cmdlet ustawia sponsorów użytkownika (użytkowników lub grup). Funkcja sponsora śledzi, kto jest odpowiedzialny za każdego użytkownika-gościa, przypisując osobę lub grupę, zapewniając odpowiedzialność.

Update-EntraUserSponsor to alias dla elementu Set-EntraUserSponsor.

W scenariuszach delegowanych z kontami służbowymi zalogowany użytkownik musi mieć obsługiwaną rolę Microsoft Entra lub rolę niestandardową zawierającą microsoft.directory/users/sponsors/update uprawnienia.

Następujące najmniej uprzywilejowane role obsługują tę operację:

  • Autorzy katalogów
  • Administrator użytkowników

Przykłady

Przykład 1. Przypisywanie sponsora pojedynczego użytkownika

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

W tym przykładzie pokazano, jak przypisać pojedynczego użytkownika jako sponsora do docelowego konta użytkownika.

  • Parametr -UserId określa identyfikator użytkownika lub główną nazwę użytkownika. Możesz użyć , -UserPrincipalName, -Identity-UPN-ObjectId , jako aliasu dla .-UserId
  • Parametr -Type określa typ sponsora przypisanego do użytkownika. Obsługiwane typy sponsorów to (użytkownik lub grupa).
  • Parametr -SponsorIds określa identyfikatory sponsorów, które mają być przypisane do użytkownika.

Przykład 2. Przypisywanie sponsora pojedynczej grupy

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

W tym przykładzie pokazano, jak przypisać pojedynczą grupę jako sponsora do docelowego konta użytkownika.

  • Parametr -UserId określa identyfikator użytkownika lub główną nazwę użytkownika. Możesz użyć , -UserPrincipalName, -Identity-UPN-ObjectId , jako aliasu dla .-UserId
  • Parametr -Type określa typ sponsora przypisanego do użytkownika. Obsługiwane typy sponsorów to (użytkownik lub grupa).
  • Parametr -SponsorIds określa identyfikatory sponsorów, które mają być przypisane do użytkownika.

Przykład 3. Przypisywanie wielu sponsorów użytkowników

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")

W tym przykładzie pokazano, jak przypisać wielu użytkowników jako sponsorów do docelowego konta użytkownika.

  • Parametr -UserId określa identyfikator użytkownika lub główną nazwę użytkownika. Możesz użyć , -UserPrincipalName, -Identity-UPN-ObjectId , jako aliasu dla .-UserId
  • Parametr -Type określa typ sponsora przypisanego do użytkownika. Obsługiwane typy sponsorów to (użytkownik lub grupa).
  • Parametr -SponsorIds określa identyfikatory sponsorów, które mają być przypisane do użytkownika.

Przykład 4. Przypisywanie wielu sponsorów grup

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")

W tym przykładzie pokazano, jak przypisać wiele grup jako sponsorów do docelowego konta użytkownika.

  • Parametr -UserId określa identyfikator użytkownika lub główną nazwę użytkownika. Możesz użyć , -UserPrincipalName, -Identity-UPN-ObjectId , jako aliasu dla .-UserId
  • Parametr -Type określa typ sponsora przypisanego do użytkownika. Obsługiwane typy sponsorów to (użytkownik lub grupa).
  • Parametr -SponsorIds określa identyfikatory sponsorów, które mają być przypisane do użytkownika.

Parametry

-SponsorId

Określa identyfikator sponsora (identyfikator użytkownika lub grupy), który ma zostać przypisany do określonego obiektu docelowego użytkownika.

Właściwości parametru

Typ:

System.String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Type

Określa typ sponsorów przypisanych do użytkownika. Obsługiwane typy sponsorów to (użytkownik lub grupa).

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-UserId

Określa identyfikator (jako UserPrincipalName lub UserId) użytkownika w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu, nazwa UPN, Identity, NazwaGłównaUżytkownika

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.