Set-EntraUserSponsor
Imposta gli sponsor di un utente (utenti o gruppi).
Sintassi
SetUserSponsor (Impostazione predefinita)
Set-EntraUserSponsor
-UserId <String>
-Type <String>
-SponsorIds <String[]>
[<CommonParameters>]
Descrizione
Il Set-EntraUserSponsor cmdlet imposta gli sponsor di un utente (utenti o gruppi). La funzionalità sponsor tiene traccia di chi è responsabile di ogni utente guest assegnando una persona o un gruppo, garantendo la responsabilità.
Update-EntraUserSponsor è un alias per Set-EntraUserSponsor.
Negli scenari delegati con account aziendali o dell'istituto di istruzione, l'utente connesso deve avere un ruolo di Microsoft Entra supportato o un ruolo personalizzato che include l'autorizzazionemicrosoft.directory/users/sponsors/update.
I ruoli con privilegi minimi seguenti supportano questa operazione:
- Scrittori della Directory
- Amministratore utenti
Esempio
Esempio 1: Assegnare uno sponsor utente singolo
Connect-Entra -Scopes 'User.ReadWrite.All'
$sponsor = Get-EntraUser -UserId 'SponsorEmail@contoso.com'
Set-EntraUserSponsor -UserId 'JohnstoneH@fabrikam.com' -Type User -SponsorIds $sponsor.Id
Questo esempio illustra come assegnare un singolo utente, come sponsor a un account utente di destinazione.
- Il
-UserIdparametro specifica l'ID utente o il nome dell'entità utente. È possibile usare-UserPrincipalName,-Identity,-UPN,-ObjectIdcome alias per-UserId. - Il
-Typeparametro specifica il tipo di sponsor assegnato all'utente. I tipi di sponsor supportati sono (utente o gruppo). - Il
-SponsorIdsparametro specifica gli ID degli sponsor da assegnare all'utente.
Esempio 2: Assegnare uno sponsor a gruppo singolo
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
Questo esempio illustra come assegnare un singolo gruppo, come sponsor a un account utente di destinazione.
- Il
-UserIdparametro specifica l'ID utente o il nome dell'entità utente. È possibile usare-UserPrincipalName,-Identity,-UPN,-ObjectIdcome alias per-UserId. - Il
-Typeparametro specifica il tipo di sponsor assegnato all'utente. I tipi di sponsor supportati sono (utente o gruppo). - Il
-SponsorIdsparametro specifica gli ID degli sponsor da assegnare all'utente.
Esempio 3: Assegnare più sponsor utente
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")
Questo esempio illustra come assegnare più utenti come sponsor a un account utente di destinazione.
- Il
-UserIdparametro specifica l'ID utente o il nome dell'entità utente. È possibile usare-UserPrincipalName,-Identity,-UPN,-ObjectIdcome alias per-UserId. - Il
-Typeparametro specifica il tipo di sponsor assegnato all'utente. I tipi di sponsor supportati sono (utente o gruppo). - Il
-SponsorIdsparametro specifica gli ID degli sponsor da assegnare all'utente.
Esempio 4: Assegnare più sponsor di gruppo
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")
Questo esempio illustra come assegnare più gruppi come sponsor a un account utente di destinazione.
- Il
-UserIdparametro specifica l'ID utente o il nome dell'entità utente. È possibile usare-UserPrincipalName,-Identity,-UPN,-ObjectIdcome alias per-UserId. - Il
-Typeparametro specifica il tipo di sponsor assegnato all'utente. I tipi di sponsor supportati sono (utente o gruppo). - Il
-SponsorIdsparametro specifica gli ID degli sponsor da assegnare all'utente.
Parametri
-SponsorId
Specifica l'ID sponsor (ID utente o gruppo) da assegnare alla destinazione utente specifica.
Proprietà dei parametri
| Tipo: | System.String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Type
Specifica il tipo di sponsor assegnati all'utente. I tipi di sponsor supportati sono (utente o gruppo).
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-UserId
Specifica l'ID (come UserPrincipalName o UserId) di un utente in Microsoft Entra ID.
Proprietà dei parametri
| Tipo: | System.String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | ObjectId, UPN, Identità, NomePrincipaleUtente |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.