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
-UserIdokreśla identyfikator użytkownika lub główną nazwę użytkownika. Możesz użyć ,-UserPrincipalName,-Identity-UPN-ObjectId, jako aliasu dla .-UserId - Parametr
-Typeokreśla typ sponsora przypisanego do użytkownika. Obsługiwane typy sponsorów to (użytkownik lub grupa). - Parametr
-SponsorIdsokreś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
-UserIdokreśla identyfikator użytkownika lub główną nazwę użytkownika. Możesz użyć ,-UserPrincipalName,-Identity-UPN-ObjectId, jako aliasu dla .-UserId - Parametr
-Typeokreśla typ sponsora przypisanego do użytkownika. Obsługiwane typy sponsorów to (użytkownik lub grupa). - Parametr
-SponsorIdsokreś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
-UserIdokreśla identyfikator użytkownika lub główną nazwę użytkownika. Możesz użyć ,-UserPrincipalName,-Identity-UPN-ObjectId, jako aliasu dla .-UserId - Parametr
-Typeokreśla typ sponsora przypisanego do użytkownika. Obsługiwane typy sponsorów to (użytkownik lub grupa). - Parametr
-SponsorIdsokreś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
-UserIdokreśla identyfikator użytkownika lub główną nazwę użytkownika. Możesz użyć ,-UserPrincipalName,-Identity-UPN-ObjectId, jako aliasu dla .-UserId - Parametr
-Typeokreśla typ sponsora przypisanego do użytkownika. Obsługiwane typy sponsorów to (użytkownik lub grupa). - Parametr
-SponsorIdsokreś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.