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 プロパティに 基づいて計算されます。 使用できる値は、 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 の移行ガイド を参照してください。