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 -UserId parametro specifica l'ID utente o il nome dell'entità utente. È possibile usare -UserPrincipalName, -Identity, -UPN, -ObjectId come alias per -UserId.
  • Il -Type parametro specifica il tipo di sponsor assegnato all'utente. I tipi di sponsor supportati sono (utente o gruppo).
  • Il -SponsorIds parametro 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 -UserId parametro specifica l'ID utente o il nome dell'entità utente. È possibile usare -UserPrincipalName, -Identity, -UPN, -ObjectId come alias per -UserId.
  • Il -Type parametro specifica il tipo di sponsor assegnato all'utente. I tipi di sponsor supportati sono (utente o gruppo).
  • Il -SponsorIds parametro 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 -UserId parametro specifica l'ID utente o il nome dell'entità utente. È possibile usare -UserPrincipalName, -Identity, -UPN, -ObjectId come alias per -UserId.
  • Il -Type parametro specifica il tipo di sponsor assegnato all'utente. I tipi di sponsor supportati sono (utente o gruppo).
  • Il -SponsorIds parametro 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 -UserId parametro specifica l'ID utente o il nome dell'entità utente. È possibile usare -UserPrincipalName, -Identity, -UPN, -ObjectId come alias per -UserId.
  • Il -Type parametro specifica il tipo di sponsor assegnato all'utente. I tipi di sponsor supportati sono (utente o gruppo).
  • Il -SponsorIds parametro 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.