Set-EntraUserSponsor

モジュール:
Microsoft.Entra.Users Module v1.3

ユーザーのスポンサー (ユーザーまたはグループ) を設定します。

構文

SetUserSponsor (既定) 

Set-EntraUserSponsor

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

説明

Set-EntraUserSponsor コマンドレットは、ユーザーのスポンサー (ユーザーまたはグループ) を設定します。 スポンサー機能は、ユーザーまたはグループを割り当てて説明責任を確保することで、各ゲスト ユーザーの責任者を追跡します。

Update-EntraUserSponsor は Set-EntraUserSponsor の別名です。

職場または学校アカウントを使用する委任されたシナリオでは、サインインしているユーザーは、サポートされているMicrosoft Entraロールまたはmicrosoft.directory/users/sponsors/updateアクセス許可を含むカスタム ロールを持っている必要があります。

この操作は、次の最小特権ロールでサポートされています。

  • ディレクトリ製作者
  • ユーザー管理者

例

例 1: シングル ユーザー スポンサーを割り当てる

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

この例では、1 人のユーザーをスポンサーとしてターゲット ユーザー アカウントに割り当てる方法を示します。

  • -UserId パラメーターは、ユーザー ID またはユーザー プリンシパル名を指定します。 -UserPrincipalName、-Identity、-UPN、-ObjectIdを-UserIdのエイリアスとして使用できます。
  • -Type パラメーターは、ユーザーに割り当てるスポンサーの種類を指定します。 サポートされているスポンサーの種類は (ユーザーまたはグループ) です。
  • -SponsorIds パラメーターは、ユーザーに割り当てるスポンサーの ID を指定します。

例 2: 単一グループ スポンサーを割り当てる

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

この例では、1 つのグループをスポンサーとしてターゲット ユーザー アカウントに割り当てる方法を示します。

  • -UserId パラメーターは、ユーザー ID またはユーザー プリンシパル名を指定します。 -UserPrincipalName、-Identity、-UPN、-ObjectIdを-UserIdのエイリアスとして使用できます。
  • -Type パラメーターは、ユーザーに割り当てるスポンサーの種類を指定します。 サポートされているスポンサーの種類は (ユーザーまたはグループ) です。
  • -SponsorIds パラメーターは、ユーザーに割り当てるスポンサーの ID を指定します。

例 3: 複数のユーザー スポンサーを割り当てる

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

この例では、複数のユーザーをスポンサーとしてターゲット ユーザー アカウントに割り当てる方法を示します。

  • -UserId パラメーターは、ユーザー ID またはユーザー プリンシパル名を指定します。 -UserPrincipalName、-Identity、-UPN、-ObjectIdを-UserIdのエイリアスとして使用できます。
  • -Type パラメーターは、ユーザーに割り当てるスポンサーの種類を指定します。 サポートされているスポンサーの種類は (ユーザーまたはグループ) です。
  • -SponsorIds パラメーターは、ユーザーに割り当てるスポンサーの ID を指定します。

例 4: 複数のグループ スポンサーを割り当てる

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

この例では、複数のグループをスポンサーとしてターゲット ユーザー アカウントに割り当てる方法を示します。

  • -UserId パラメーターは、ユーザー ID またはユーザー プリンシパル名を指定します。 -UserPrincipalName、-Identity、-UPN、-ObjectIdを-UserIdのエイリアスとして使用できます。
  • -Type パラメーターは、ユーザーに割り当てるスポンサーの種類を指定します。 サポートされているスポンサーの種類は (ユーザーまたはグループ) です。
  • -SponsorIds パラメーターは、ユーザーに割り当てるスポンサーの ID を指定します。

パラメーター

-SponsorId

特定のユーザー ターゲットに割り当てるスポンサー ID (ユーザーまたはグループ ID) を指定します。

パラメーターのプロパティ

型:

System.String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Type

ユーザーに割り当てるスポンサーの種類を指定します。 サポートされているスポンサーの種類は (ユーザーまたはグループ) です。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-UserId

Microsoft Entra IDのユーザーの ID (UserPrincipalName または UserId) を指定します。

パラメーターのプロパティ

型:System.String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:オブジェクト識別子, UPN, アイデンティティ, ユーザープリンシパルネーム

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。