Set-AzureADUser

リファレンス

モジュール:: AzureAD

ユーザーの更新。

構文

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

説明

Set-AzureADUser コマンドレットは、Azure Active Directory (AD) のユーザーを更新します。

例

例 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

アカウントが有効かどうかを示します。

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

-AgeGroup

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

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

-City

ユーザーの市区町村を指定します。

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

-CompanyName

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

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

-ConsentProvidedForMinor

未成年の同意が得られたかどうかを設定します。使用できる値は、 null、 granted、 denied および notRequiredです。詳細については、[法的年齢グループのプロパティの定義][年齢グループとマイナー同意の定義の詳細] を参照してください。

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

-Country

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

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

-CreationType

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

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

-Department

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

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

-DisplayName

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

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

-ExtensionProperty

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

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

-FacsimileTelephoneNumber

ユーザーの FAX 番号。

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

-GivenName

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

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

-ImmutableId

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

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

-IsCompromised

このユーザーが侵害された場合は True

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

-JobTitle

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

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

-MailNickName

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

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

-Mobile

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

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

-ObjectId

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

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

-OtherMails

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

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

-PasswordPolicies

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

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

-PasswordProfile

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

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

-PhysicalDeliveryOfficeName

ユーザーの勤務先のオフィス所在地。最大長は 128 文字です。

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

-PostalCode

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

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

-PreferredLanguage

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

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

-ShowInAddressList

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

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

-SignInNames

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

型:	List<T>[Microsoft.Open.AzureAD.Model.SignInName]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-State

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

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

-StreetAddress

ユーザーの番地を指定します。

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

-Surname

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

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

-TelephoneNumber

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

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

-UsageLocation

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

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

-UserPrincipalName

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

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

-UserState

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

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

-UserStateChangedOn

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

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

-UserType

ディレクトリ内のユーザータイプを分類するために使用できる文字列値です (例: "Member"、"Guest")。

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

メモ

Microsoft Graph PowerShell への Set-AzureADUser の移行ガイドを参照してください。

次の方法で共有