次の方法で共有


Set-AzureADUser

ユーザーの更新。

構文

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 プロパティに 基づいて計算されます。 使用できる値は、 nullminornotAdult および adultです。 [法的年齢グループのプロパティ定義][年齢グループとマイナー同意の定義の詳細] を参照してください。

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

-City

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

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

-CompanyName

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

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

-ConsentProvidedForMinor

未成年の同意が得られたかどうかを設定します。 使用できる値は、 nullgranteddenied および 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 の移行ガイド を参照してください。