Update-AzADUser

リファレンス

モジュール:: Az.Resources

ユーザーのエンティティを更新する

構文

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>]

Update-AzADUser
      [-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>]
      -ObjectId <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADUser
      [-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>]
      -InputObject <IMicrosoftGraphUser>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzADUser
      [-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>]
      -UserPrincipalName <String>
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

ユーザーのエンティティを更新する

例

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

Update-AzADUser -UPNOrObjectId $upn -City $city

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

パラメーター

-AccountEnabled

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

型:	Boolean
Aliases:	EnableAccount
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AgeGroup

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-City

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CompanyName

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ConsentProvidedForMinor

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Country

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

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

型:	PSObject
Aliases:	AzContext, AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeletedDateTime

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Department

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisplayName

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EmployeeHireDate

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

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EmployeeId

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EmployeeType

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ExternalUserState

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ExternalUserStateChangeDateTime

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

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-FaxNumber

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceChangePasswordNextLogin

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-GivenName

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

読み取り専用。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Identity

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

型:	IMicrosoftGraphObjectIdentity[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

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

型:	IMicrosoftGraphUser
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-IsResourceAccount

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-JobTitle

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Mail

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MailNickname

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ObjectId

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

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OfficeLocation

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OnPremisesImmutableId

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-OtherMail

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

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Password

ユーザーのパスワード。このプロパティは、ユーザーが作成されるときに必要です。

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

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

型:	SecureString
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PasswordPolicy

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PasswordProfile

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

型:	IMicrosoftGraphPasswordProfile
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PostalCode

ユーザーの住所の郵便番号。郵便番号は、ユーザーの国/地域に固有です。米国では、この属性には郵便番号が含まれています。最大長は 40 文字です。 $filter (eq、ne、NOT、ge、le、in、startsWith) をサポートします。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PreferredLanguage

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ShowInAddressList

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-State

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-StreetAddress

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Surname

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UPNOrObjectId

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

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UsageLocation

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserPrincipalName

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

型:	String
Aliases:	UPN
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserType

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

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

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

IMicrosoftGraphUser

出力

Boolean

メモ

エイリアス

Set-AzADUser

次の方法で共有