Update-AzADUser

構文

UPNOrObjectIdParameterSet (既定)

Update-AzADUser
    -UPNOrObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectIdParameterSet

Update-AzADUser
    -ObjectId <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectParameterSet

Update-AzADUser
    -InputObject <IMicrosoftGraphUser>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UPNParameterSet

Update-AzADUser
    -UserPrincipalName <String>
    [-AccountEnabled <Boolean>]
    [-Password <SecureString>]
    [-ForceChangePasswordNextLogin]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-DeletedDateTime <DateTime>]
    [-Department <String>]
    [-DisplayName <String>]
    [-EmployeeHireDate <DateTime>]
    [-EmployeeId <String>]
    [-EmployeeType <String>]
    [-ExternalUserState <String>]
    [-ExternalUserStateChangeDateTime <DateTime>]
    [-FaxNumber <String>]
    [-GivenName <String>]
    [-Id <String>]
    [-Identity <IMicrosoftGraphObjectIdentity[]>]
    [-IsResourceAccount]
    [-JobTitle <String>]
    [-Mail <String>]
    [-MailNickname <String>]
    [-OfficeLocation <String>]
    [-OnPremisesImmutableId <String>]
    [-OtherMail <String[]>]
    [-PasswordPolicy <String>]
    [-PasswordProfile <IMicrosoftGraphPasswordProfile>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-UsageLocation <String>]
    [-UserType <String>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

例

例 1: ユーザー プリンシパル名でユーザーを更新する

Update-AzADUser -UPNOrObjectId $upn -City $city

パラメーター

-AccountEnabled

アカウントを有効にする場合は true。それ以外の場合は false。 -Passwordと組み合わせた場合は常に true。 -AccountEnabled $false は、アカウントのパスワードを変更するときに無視されます。

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

パラメーター セット

-AgeGroup

ユーザーの年齢グループを設定します。 使用できる値: null、minor、notAdult、adult。 詳細については、法的年齢グループのプロパティ定義を参照してください。 $filter (eq、ne、NOT、in) をサポートします。

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

パラメーター セット

-City

ユーザーがいる都市。 最大文字数は 128 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-CompanyName

ユーザーが関連付けられている会社名。 このプロパティは、外部ユーザーが所属する会社を記述するのに役立ちます。 会社名の最大長は 64 文字です。$filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

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

パラメーター セット

-ConsentProvidedForMinor

未成年者について同意を得ているかどうかを設定します。 使用できる値: null、許可、拒否、および notRequired。 詳細については、法的年齢グループのプロパティ定義を参照してください。 $filter (eq、ne、NOT、in) をサポートします。

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

パラメーター セット

-Country

ユーザーが配置されている国/地域。たとえば、米国や英国などです。 最大文字数は 128 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

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

パラメーター セット

-DeletedDateTime

.

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

パラメーター セット

-Department

ユーザーが働いている部門の名前。 最大長は 64 文字です。$filter (eq、ne、NOT、ge、le、および in 演算子) をサポートします。

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

パラメーター セット

-DisplayName

アドレス帳に表示されるユーザーの名前。 この値は通常、ユーザーの名前、ミドルネームのイニシャル、姓の組み合わせになります。 このプロパティは、ユーザーが作成され、更新中にクリアできない場合に必要です。 最大長は 256 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith)、$orderBy、および$searchをサポートします。

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

パラメーター セット

-EmployeeHireDate

ユーザーが採用された日時、または将来の採用の場合に作業を開始する日時。 $filter (eq、ne、NOT、ge、le、in) をサポートします。

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

パラメーター セット

-EmployeeId

組織によりユーザーに割り当てられた従業員 ID。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-EmployeeType

エンタープライズ ワーカーの種類を取得します。 たとえば、従業員、請負業者、コンサルタント、ベンダーなどです。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-ExternalUserState

招待 API を使用してテナントに招待された外部ユーザーの場合、このプロパティは招待されたユーザーの招待状態を表します。 招待されたユーザーの場合、状態は PendingAcceptance または Accepted、または他のすべてのユーザーの場合は null にすることができます。 $filter (eq、ne、NOT、in) をサポートします。

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

パラメーター セット

-ExternalUserStateChangeDateTime

externalUserState プロパティに対する最終変更のタイムスタンプを示します。 $filter (eq、ne、NOT、in) をサポートします。

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

パラメーター セット

-FaxNumber

ユーザーの Fax 番号。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-ForceChangePasswordNextLogin

次に成功したログインでユーザーがパスワードを変更する必要がある場合は、これを指定する必要があります (true)。 次に成功したログインでパスワードを変更しない場合の既定の動作は (false) です。

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

パラメーター セット

-GivenName

ユーザーの名。 最大文字数は 64 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-Id

読み取り専用。

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

パラメーター セット

-Identity

このユーザー アカウントへのサインインに使用できる ID を表します。 ID は、Microsoft (ローカル アカウントとも呼ばれます)、組織、または Facebook、Google、Microsoft などのソーシャル ID プロバイダーによって提供され、ユーザー アカウントに関連付けることができます。 同じ signInType 値を持つ複数の項目を含む場合があります。 signInType が userPrincipalName でない場合にのみ、$filter (eq) をサポートします。 構築するには、IDENTITY プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

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

パラメーター セット

-InputObject

ユーザー入力オブジェクト

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

パラメーター セット

-IsResourceAccount

使用しない - 将来の使用のために予約されています。

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

パラメーター セット

-JobTitle

ユーザーの役職。 最大文字数は 128 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-Mail

ユーザーの SMTP アドレス (たとえば、admin@contoso.com)。 このプロパティを変更すると、ユーザーの proxyAddresses コレクションも更新され、SMTP アドレスとして値が含まれます。 このプロパティにはアクセント記号を含めることができますが、使用すると、ユーザーの他の Microsoft アプリケーションでアクセスの問題が発生する可能性があります。 $filter (eq、ne、NOT、ge、le、in、startsWith、endsWith) をサポートします。

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

パラメーター セット

-MailNickname

ユーザーの電子メール エイリアス。 ユーザーの作成時に、このプロパティを指定する必要があります。 最大文字数は 64 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-ObjectId

更新するユーザーのユーザー プリンシパル名。

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

パラメーター セット

-OfficeLocation

ユーザーの勤務先の場所。 最大文字数は 128 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-OnPremisesImmutableId

このプロパティは、オンプレミスの Active Directory ユーザー アカウントを Azure AD ユーザー オブジェクトに関連付けるために使用されます。 ユーザーの userPrincipalName (UPN) プロパティにフェデレーション ドメインを使用している場合は、Graph で新しいユーザー アカウントを作成するときに、このプロパティを指定する必要があります。 注: このプロパティを指定する場合、$ 文字と _ 文字は使用できません。 $selectでのみ返されます。 $filter (eq、ne、NOT、ge、le、in) をサポートします。

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

パラメーター セット

-OtherMail

ユーザーの追加の電子メール アドレスの一覧。例: ['bob@contoso.com', 'Robert@fabrikam.com']。注: このプロパティにはアクセント記号を含めることができますが、ユーザーのファースト パーティ アプリケーションへのアクセスの問題が発生する可能性があります。$filter (eq、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-PassThru

コマンドが成功したときに true を返します。

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

パラメーター セット

-Password

ユーザーのパスワードです。 このプロパティは、ユーザーの作成時に必要です。

更新することはできますが、ユーザーは次のログイン時にパスワードを変更する必要があります。

パスワードは、ユーザーの passwordPolicies プロパティで指定されている最小要件を満たす必要があります。 既定では、強力なパスワードが必要です。 このメソッドを使用してパスワードを変更する場合、AccountEnabled は true に設定されます。

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

パラメーター セット

-PasswordPolicy

ユーザーのパスワード ポリシーを指定します。 この値は、1 つの可能な値が DisableStrongPassword である列挙です。これにより、既定のポリシーよりも脆弱なパスワードを指定できます。 DisablePasswordExpiration を指定することもできます。 2 つの値を一緒に指定できます。例: DisablePasswordExpiration、DisableStrongPassword.Supports $filter (ne, NOT)。

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

パラメーター セット

-PasswordProfile

passwordProfile 構築するには、PASSWORDPROFILE プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

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

パラメーター セット

-PostalCode

ユーザーの住所の郵便番号。 郵便番号は、ユーザーの国/地域に固有です。 アメリカ合衆国では、この属性には、ZIP コードが含まれます。 最大文字数は 40 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-PreferredLanguage

ユーザーが設定する言語。 ISO 639-1 コードに従う必要があります。たとえば、en-US. $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-ShowInAddressList

Outlook グローバル アドレス一覧にこのユーザーを含める必要がある場合は true、それ以外の場合は false。 設定されていない場合、これは true として扱われます。 招待マネージャーを通じて招待されたユーザーの場合、このプロパティは false に設定されます。 $filter (eq、ne、NOT、in) をサポートします。

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

パラメーター セット

-State

ユーザーの住所の都道府県。 最大文字数は 128 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-StreetAddress

ユーザーの勤務先の番地。 最大文字数は 1024 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-Surname

ユーザーの姓。 最大文字数は 64 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-UPNOrObjectId

更新するユーザーのユーザー プリンシパル名またはオブジェクト ID。

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

パラメーター セット

-UsageLocation

2 文字の国コード (ISO 規格 3166) 国でのサービスの可用性を確認するための法的要件により、ライセンスが割り当てられるユーザーに必要です。 例としては、米国、JP、GB などがあります。 null 許容ではありません。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

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

パラメーター セット

-UserPrincipalName

ユーザーのユーザー プリンシパル名 (UPN)。 UPN は、インターネット標準 RFC 822 に基づくユーザーのインターネット スタイルのログイン名です。 規則では、これはユーザーの電子メール名にマップされる必要があります。 一般的な形式は alias@domain です。このドメインは、検証済みドメインのテナントのコレクション内に存在している必要があります。 このプロパティは、ユーザーの作成時に必要です。 テナントの検証済みドメインには、組織の verifiedDomains プロパティからアクセスできます。注: このプロパティにはアクセント記号を含めることができますが、ユーザーのファースト パーティ アプリケーションへのアクセスの問題が発生する可能性があります。 $filter (eq、ne、NOT、ge、le、in、startsWith、endsWith) と$orderByをサポートします。

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

パラメーター セット

-UserType

Member や Guest など、ディレクトリ内のユーザーの種類を分類するために使用できる文字列値。 $filter (eq、ne、NOT、in)をサポートします。

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

パラメーター セット

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

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

パラメーター セット

CommonParameters

入力

IMicrosoftGraphUser

出力

Boolean

メモ