Set-AzureADUser

構文

Default (既定)

Set-AzureADUser
    -ObjectId <String>
    [-ExtensionProperty <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
    [-AccountEnabled <Boolean>]
    [-AgeGroup <String>]
    [-City <String>]
    [-CompanyName <String>]
    [-ConsentProvidedForMinor <String>]
    [-Country <String>]
    [-CreationType <String>]
    [-Department <String>]
    [-DisplayName <String>]
    [-FacsimileTelephoneNumber <String>]
    [-GivenName <String>]
    [-IsCompromised <Boolean>]
    [-ImmutableId <String>]
    [-JobTitle <String>]
    [-MailNickName <String>]
    [-Mobile <String>]
    [-OtherMails <System.Collections.Generic.List`1[System.String]>]
    [-PasswordPolicies <String>]
    [-PasswordProfile <PasswordProfile>]
    [-PhysicalDeliveryOfficeName <String>]
    [-PostalCode <String>]
    [-PreferredLanguage <String>]
    [-ShowInAddressList <Boolean>]
    [-SignInNames <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.SignInName]>]
    [-State <String>]
    [-StreetAddress <String>]
    [-Surname <String>]
    [-TelephoneNumber <String>]
    [-UsageLocation <String>]
    [-UserPrincipalName <String>]
    [-UserState <String>]
    [-UserStateChangedOn <String>]
    [-UserType <String>]
    [<CommonParameters>]

説明

例

例 1: ユーザーを更新する

PS C:\> $user = Get-AzureADUser -ObjectId TestUser@example.com
PS C:\> $user.DisplayName = 'YetAnotherTestUser'
PS C:\> Set-AzureADUser -ObjectId TestUser@example.com -Displayname $user.Displayname

例 2: 指定したユーザーを除くすべてのユーザーを、保護者の同意を得た未成年者として設定する

Get-AzureADUser -All $true |
Where-Object -FilterScript { $_.DisplayName -notmatch '(George|James|Education)' } |
ForEach-Object  { Set-AzureADUser -ObjectId $($_.ObjectId) -AgeGroup 'minor' -ConsentProvidedForMinor 'granted' }

パラメーター

-AccountEnabled

アカウントが有効になっているかどうかを示します。

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

パラメーター セット

-AgeGroup

エンタープライズ アプリケーションで使用され、ユーザーの法的年齢グループを示します。 このプロパティは読み取り専用で、ageGroup と consentProvidedForMinor プロパティに基づいて計算されます。 使用できる値: null、minor、notAdult、および adult。 [法定年齢層のプロパティの定義][年齢層と未成年者の同意の定義の詳細] をご覧ください。

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

パラメーター セット

-City

ユーザーの都市を指定します。

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

パラメーター セット

-CompanyName

ユーザーが関連付けられている会社の名前。 このプロパティは、外部ユーザーの元の会社を記述する場合に役立ちます。 会社名の最大長は 64 文字です。

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

パラメーター セット

-ConsentProvidedForMinor

未成年者の同意が得られたかどうかを設定します。 使用できる値: null、granted、denied、および notRequired。 詳しくは、[法定年齢層のプロパティの定義][年齢層と未成年者の同意の定義の詳細] をご覧ください。

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

パラメーター セット

-Country

ユーザーの国または地域を指定します。

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

パラメーター セット

-CreationType

ユーザー アカウントが Azure Active Directory B2C テナントのローカル アカウントであるかどうかを示します。 指定できる値は "LocalAccount" と null です。 ローカルアカウントを作成するときは、プロパティが必須であり、"LocalAccount"に設定する必要があります。 職場または学校のアカウントを作成するときは、プロパティを指定したり、null に設定したりしないでください。

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

パラメーター セット

-Department

ユーザーの部署を指定します。

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

パラメーター セット

-DisplayName

ユーザーの表示名を指定します。

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

パラメーター セット

-ExtensionProperty

カスタム ユーザー プロパティに、基本的な オープン拡張機能 またはより汎用性の高い スキーマ拡張機能としてデータを追加します。 [拡張機能の詳細][拡張機能の詳細] を参照してください。

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

パラメーター セット

-FacsimileTelephoneNumber

ユーザーの FAX 番号。

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

パラメーター セット

-GivenName

ユーザーの名を指定します。

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

パラメーター セット

-ImmutableId

このプロパティは、オンプレミスの Active Directoryユーザー アカウントを Azure AD ユーザー オブジェクトに関連付けるために使用されます。 このプロパティは、ユーザーの userPrincipalName (UPN) プロパティにフェデレーション ドメインを使用している場合は、グラフで新しいユーザー アカウントを作成するときに指定する必要があります。 大事な： このプロパティを指定するときに、 $ 文字と _ 文字は使用できません。

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

パラメーター セット

-IsCompromised

このユーザーが侵害されている場合は True

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

パラメーター セット

-JobTitle

ユーザーの役職を指定します。

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

パラメーター セット

-MailNickName

ユーザーのメールアドレスのニックネームを指定します。

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

パラメーター セット

-Mobile

ユーザーの携帯電話番号を指定します。

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

パラメーター セット

-ObjectId

Azure AD のユーザーの ID (UPN または ObjectId) を指定します。

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

パラメーター セット

-OtherMails

ユーザーの他の電子メール アドレスを指定します。

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

パラメーター セット

-PasswordPolicies

ユーザーのパスワード ポリシーを指定します。

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

パラメーター セット

-PasswordProfile

ユーザーのパスワード プロファイルを指定します。

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

パラメーター セット

-PhysicalDeliveryOfficeName

ユーザーの事業所内にあるオフィスの場所。 最大長は 128 文字です。

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

パラメーター セット

-PostalCode

ユーザーの郵便番号を指定します。

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

パラメーター セット

-PreferredLanguage

ユーザーの優先言語を指定します。

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

パラメーター セット

-ShowInAddressList

このユーザーをアドレス一覧に表示するには、True に設定します。

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

パラメーター セット

-SignInNames

このユーザーのサインイン名の一覧

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

パラメーター セット

-State

ユーザーの状態を指定します。

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

パラメーター セット

-StreetAddress

ユーザーの住所を指定します。

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

パラメーター セット

-Surname

ユーザーの姓を指定します。

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

パラメーター セット

-TelephoneNumber

ユーザーの電話番号を指定します。

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

パラメーター セット

-UsageLocation

2 文字の国または地域コード (ISO 規格 3166)。 国や地域でのサービスの可用性を確認するための法的要件により、ライセンスが割り当てられるユーザーに必要です。 たとえば、"US"、"JP"、"GB" などです。 NULL 値は許可されません。

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

パラメーター セット

-UserPrincipalName

ユーザーのユーザー プリンシパル名を指定します。

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

パラメーター セット

-UserState

invitation API を使用してテナントに招待された外部ユーザーの場合、このプロパティは招待されたユーザーの招待の状態を示します。 招待されたユーザーの状態は PendingAcceptance、Accepted、または null (その他のすべてのユーザー) です。

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

パラメーター セット

-UserStateChangedOn

externalUserState プロパティに対する最新の変更のタイムスタンプを表示します。

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

パラメーター セット

-UserType

ディレクトリ内のユーザーの種類を分類するために使用する文字列値 (“Member”、“Guest” など)。

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

パラメーター セット

CommonParameters

メモ

関連リンク

• Get-AzureADUser
• New-AzureADUser
• Remove-AzureADUser