Update-EntraBetaUserFromFederated

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

シングル サインオン (ID フェデレーションとも呼ばれます) から標準認証の種類に最近変換されたドメイン内のユーザーを更新します。

構文

CloudOnlyPasswordScenarios (既定) 

Update-EntraBetaUserFromFederated

    -UserPrincipalName <String>
    [<CommonParameters>]

HybridPasswordScenarios 

Update-EntraBetaUserFromFederated

    -UserPrincipalName <String>
    -NewPassword <SecureString>
    [<CommonParameters>]

説明

Update-EntraBetaUserFromFederated コマンドレットは、シングル サインオン (ID フェデレーションとも呼ばれます) から標準認証の種類に最近変換されたドメイン内のユーザーを更新するために使用されます。 ユーザーに新しいパスワードを指定する必要があります。

このプロセスでは、Microsoft Entra IDでパスワードが更新され、パスワード ライトバックが有効になっている場合は、パスワードをオンプレミスの Active Directoryに同期します。 管理者は、新しいパスワードを設定するか、システムにパスワードを生成させることができます。 ユーザーは、次回のサインイン時に変更する必要があります。

職場または学校アカウントを使用する委任されたシナリオでは、サインインしているユーザーは、サポートされているMicrosoft Entraロールまたは必要なアクセス許可を持つカスタム ロールを持っている必要があります。 この操作の最小特権ロールは次のとおりです。

  • 認証管理者
  • 特権認証管理者

委任されたシナリオの場合、管理者には少なくとも認証管理者または特権認証管理者のMicrosoft Entraロールが必要です。

User Administrator、Helpdesk Administrator、またはPassword Administratorロールを持つ管理者は、管理者以外のユーザーのパスワードをリセットできます。

ハイブリッド パスワードのセットアップには、新しいパスワードが必要です。 クラウド専用パスワードを省略すると、システムによって生成されたパスワードが返されます。 これは Unicode 文字列であり、テナントの禁止パスワード リストに対して検証され、クラウドやオンプレミスのパスワード ポリシーを満たす必要があります。

例

例 1: ドメイン内のユーザーを更新する

Connect-Entra -Scopes 'UserAuthenticationMethod.ReadWrite.All'
Update-EntraBetaUserFromFederated -UserPrincipalName 'pattifuller@contoso.com'

Name                           Value
----                           -----
newPassword                    HuHu8765
@odata.context                 https://graph.microsoft.com/beta/$metadata#microsoft.graph.passwordResetResponse

このコマンドは、ドメイン内のユーザーを更新します。 システムはパスワードを生成して返します。

  • -UserPrincipalNameパラメーターは、ユーザーが変換するMicrosoft Entra ID UserID を指定します。

例 2: ドメイン内のユーザー パスワードを更新する

Connect-Entra -Scopes 'UserAuthenticationMethod.ReadWrite.All'
$newPassword = '<strong-password>'
$securePassword = ConvertTo-SecureString $newPassword -AsPlainText -Force
Update-EntraBetaUserFromFederated -UserPrincipalName 'pattifuller@contoso.com' -NewPassword $securePassword

このコマンドは、ハイブリッド シナリオのパスワードを指定して、ドメイン内のユーザーを更新します。

  • -UserPrincipalNameパラメーターは、ユーザーが変換するMicrosoft Entra ID UserID を指定します。
  • -NewPassword パラメーターは、ユーザーの新しいパスワードを指定します。

パラメーター

-NewPassword

ユーザーの新しいパスワード。

ハイブリッド パスワード シナリオを使用するテナントの場合は、新しいパスワードを指定する必要があります。 クラウド専用アカウントのパスワードを省略すると、自動的にパスワードが生成されます。 この生成されたパスワードは、他のエンコードなしの Unicode 文字列です。 同意する前に、パスワードはテナントの禁止パスワード リストに対して検証され、テナントのクラウドまたはオンプレミスのパスワード要件を満たす必要があります。

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

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

パラメーター セット

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

-UserPrincipalName

変換するユーザーのMicrosoft Entra ID UserID。

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

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

パラメーター セット

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

CommonParameters

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

メモ

  • 詳細については、 resetPassword を参照してください。