Set-User
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
Set-User コマンドレットを使用してユーザー属性を変更します。 このコマンドレットを使用すると、ユーザー アカウントを持つすべてのオブジェクト (たとえば、ユーザーのメールボックス、メール ユーザー、ユーザー アカウントなど) を変更できます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-User
[-Identity] <UserIdParameter>
[-AllowUMCallsFromNonUsers <AllowUMCallsFromNonUsersFlags>]
[-Arbitration]
[-AssistantName <String>]
[-AuthenticationPolicy <String>]
[-BlockCloudCache <Boolean>]
[-CanHaveCloudCache <Boolean>]
[-CertificateSubject <MultiValuedProperty>]
[-City <String>]
[-ClearDataEncryptionPolicy]
[-Company <String>]
[-Confirm]
[-CountryOrRegion <CountryInfo>]
[-CreateDTMFMap <Boolean>]
[-Department <String>]
[-DesiredWorkloads <MailboxWorkloadFlags>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-EXOModuleEnabled <Boolean>]
[-Fax <String>]
[-FirstName <String>]
[-Force]
[-GeoCoordinates <GeoCoordinates>]
[-HomePhone <String>]
[-IgnoreDefaultScope]
[-IsShadowMailbox <Boolean>]
[-Initials <String>]
[-LastName <String>]
[-LinkedCredential <PSCredential>]
[-LinkedDomainController <String>]
[-LinkedMasterAccount <UserIdParameter>]
[-MailboxRegion <String>]
[-MailboxRegionSuffix <MailboxRegionSuffixValue>]
[-ManagedOnboardingType <ManagedOnboardingType>]
[-Manager <UserContactIdParameter>]
[-MobilePhone <String>]
[-Name <String>]
[-Notes <String>]
[-Office <String>]
[-OtherFax <MultiValuedProperty>]
[-OtherHomePhone <MultiValuedProperty>]
[-OtherTelephone <MultiValuedProperty>]
[-Pager <String>]
[-PermanentlyClearPreviousMailboxInfo]
[-Phone <String>]
[-PhoneticDisplayName <String>]
[-PostalCode <String>]
[-PostOfficeBox <MultiValuedProperty>]
[-PublicFolder]
[-RemotePowerShellEnabled <Boolean>]
[-RemoveMailboxProvisioningConstraint]
[-ResetPasswordOnNextLogon <Boolean>]
[-SamAccountName <String>]
[-SeniorityIndex <Int32>]
[-SimpleDisplayName <String>]
[-SkipDualWrite]
[-StateOrProvince <String>]
[-StreetAddress <String>]
[-StsRefreshTokensValidFrom <DateTime>]
[-TelephoneAssistant <String>]
[-Title <String>]
[-UMCallingLineIds <MultiValuedProperty>]
[-UMDtmfMap <MultiValuedProperty>]
[-UserPrincipalName <String>]
[-VIP <Boolean>]
[-WebPage <String>]
[-WhatIf]
[-WindowsEmailAddress <SmtpAddress>]
[<CommonParameters>]
説明
Set-User コマンドレットにはメールボックスまたはメール ユーザーのメール関連のプロパティが含まれていません。 ユーザーのメール関連のプロパティを変更するには、オブジェクトの種類に基づいて、対応するコマンドレットを使用する必要があります (たとえば、Set-Mailbox または Set-MailUser など)。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-User -Identity Contoso\Jill -DisplayName "Jill Frank"
この例は、ユーザー Jill Frank の表示名を設定します。
例 2
Set-User -Identity Kweku@fabrikam.com -LinkedMasterAccount $null
次の使用例は、LinkedMasterAccount パラメーターを $null に設定して、リンクされたメールボックス Kweku@fabrikam.com のリンクを解除し、ユーザー メールボックスに変換します。
リンクされたメールボックスでこの手順を実行すると、メールボックスに対するすべてのアクセス許可 (送信、フル アクセス、フォルダー、予定表の委任など) が削除されます。
パラメーター
-AllowUMCallsFromNonUsers
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
AllowUMCallsFromNonUsers パラメーターは、ユニファイド メッセージング ディレクトリ検索からユーザーを除外するかどうかを指定します。
型: | AllowUMCallsFromNonUsersFlags |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Arbitration
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
Arbitration スイッチは、調停メールボックスを変更するために必要です。 このスイッチで値を指定する必要はありません。
Arbitration メールボックスは、さまざまな種類のシステム データを格納したり、メッセージング承認ワークフローを管理したりするために使用されるシステム メールボックスです。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AssistantName
AssistantName パラメーターは、ユーザーの秘書の名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-AuthenticationPolicy
AuthenticationPolicy パラメーターは、ユーザーに適用する認証ポリシーを指定します。 ポリシーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
ユーザーのポリシー割り当てを削除するには、$null値を使用します。
基本認証または (Exchange 2019 CU2 以降では) その他の従来の認証方法をブロックまたは選択的に許可するには、New-AuthenticationPolicy コマンドレットを使用して認証ポリシーを作成します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2019, Exchange Online, Exchange Online Protection |
-BlockCloudCache
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill BlockCloudCache Description }}
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-CanHaveCloudCache
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill CanHaveCloudCache Description }}
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-CertificateSubject
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
CertificateSubject パラメーターは、ユーザーのデジタル証明書の [件名] フィールドの値を指定します。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-City
City パラメーターは、ユーザーの市区町村を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ClearDataEncryptionPolicy
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill ClearDataEncryptionPolicy Description }}
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-Company
Company パラメーターは、ユーザーの会社を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$false
を使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-CountryOrRegion
CountryOrRegion パラメーターは、ユーザーの国または地域を指定します。 有効な値は、有効な ISO 3166-1 の 2 文字の国コード (オーストラリアの場合は AU など) または国の対応するフレンドリ名 (公式の ISO 3166 メンテナンスエージェンシーの短い名前とは異なる場合があります) です。
2 文字の国コードのリファレンスは、 国コード一覧で入手できます。
フレンドリ名は、Get-User コマンドレットによって CountryOrRegion プロパティ値で返されますが、フィルター操作ではフレンドリ名または 2 文字の国コードを使用できます。
型: | CountryInfo |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-CreateDTMFMap
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
CreateDTMFMap パラメーターは、受信者に対してデュアルトーン多重周波数 (DTMF) マップを作成するかどうかを指定します。 この指定により、ユニファイド メッセージング (UM) 環境で電話のキーパッドを使用して受信者を識別できます。 有効な値は次のとおりです。
- $true: 受信者に対して DTMF マップが作成されます。 これは既定の値です。
- $false: 受信者に対して DTMF マップが作成されません。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Department
Department パラメーターは、ユーザーの部署を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DesiredWorkloads
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill DesiredWorkloads Description }}
型: | Microsoft.Exchange.Data.MailboxWorkloadFlags |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-DisplayName
DisplayName パラメーターには、ユーザーの表示名を指定します。 表示名は、Exchange 管理センターと Active Directory に表示されます。 最大の長さは 256 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DomainController
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
型: | Fqdn |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EXOModuleEnabled
このパラメーターは、クラウドベースのサービスでのみ使用できます。
EXOModuleEnabled パラメーターは、Exchange Online PowerShell V3 モジュールを使用して、ユーザーが Microsoft 365 組織の PowerShell Exchange Onlineに接続できるかどうかを指定します。 有効な値は次のとおりです。
- $true: ユーザーは PowerShell Exchange Onlineに接続できます。
- $false: ユーザーは PowerShell Exchange Onlineに接続できません。
既定値は、ユーザーに割り当てられている管理役割に応じて決まります。
その他の機能 (Exchange 管理センター (EAC) を開く機能など) には、Exchange Online PowerShell へのアクセスも必要です。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-Fax
Fax パラメーターは、ユーザーの FAX 番号を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-FirstName
FirstName パラメーターには、ユーザーの名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Force
このパラメーターは、クラウドベースのサービスでのみ使用できます。
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-GeoCoordinates
GeoCoordinates パラメーターは、緯度、経度、および (必要に応じて) 高度座標でユーザーの位置を指定します。 このパラメーターの有効な値は、次のいずれかの形式を使用します。
- 緯度と経度: たとえば、"47.644125;-122.122411"
- 緯度、経度、高度: "47.644125;-122.122411;161.432"
注: ピリオド区切り記号が機能しない場合は、代わりにコンマを使用してください。
型: | GeoCoordinates |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-HomePhone
HomePhone パラメーターは、ユーザーの自宅の電話番号を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Identity
Identity パラメーターは、変更するユーザーを指定します。 ユーザーを一意に識別する任意の値を使用できます。 以下に例を示します。
- 名前
- ユーザー プリンシパル名 (UPN)
- 識別名 (DN)
- 正規 DN
- GUID
- UserPrincipalName
型: | UserIdParameter |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IgnoreDefaultScope
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
IgnoreDefaultScope スイッチは、Exchange PowerShell セッションに対する受信者の範囲の既定の設定を無視し、フォレスト全体を範囲として使用するようにコマンドに指示します。 このスイッチで値を指定する必要はありません。
このスイッチを使用すると、コマンドは、既定の範囲では現在使用できない Active Directory オブジェクトにアクセスできますが、次の制限もあります。
- DomainController パラメーターは使用できません。 このコマンドは、適切なグローバル カタログ サーバーを自動的に使用します。
- Identity パラメーターの DN しか使用できません。 エイリアスや GUID などの他の形式の ID は使用できません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Initials
Initials パラメーターには、ユーザーのミドル ネームのイニシャルを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IsShadowMailbox
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill IsShadowMailbox Description }}
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-LastName
LastName パラメーターには、ユーザーの姓を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-LinkedCredential
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
LinkedCredential パラメーターは、LinkedDomainController パラメーターで指定されたドメイン コントローラーへのアクセスに使用されるユーザー名とパスワードを指定します。
このパラメーターの値には、Get-Credential コマンドレットが必要です。 このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(Get-Credential)
を使用します。 または、このコマンドを実行する前に、資格情報を変数 (たとえば、$cred = Get-Credential
) に保存し、このパラメーターに変数名 ($cred
) を使用します。 詳細については、Get-Credentialに関するページをご覧ください。
LinkedCredential パラメーターはリンクされたユーザーでのみ使用できます。
型: | PSCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LinkedDomainController
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
LinkedDomainController パラメーターには、このユーザーがリンクされたユーザーである場合に、ユーザー アカウントが存在するフォレスト内のドメイン コントローラーを指定します。 ユーザー アカウントが存在するフォレスト内のドメイン コントローラーは、LinkedMasterAccount パラメーターで指定したアカウントのセキュリティ情報を取得するために使用されます。
このパラメーターは、リンクされたユーザーに接続している場合にのみ必要です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LinkedMasterAccount
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
LinkedMasterAccount パラメーターには、このユーザーがリンクされたユーザーである場合に、ユーザー アカウントが存在するフォレスト内のマスター アカウントを指定します。 マスター アカウントは、ユーザーのリンク先となるアカウントです。 マスター アカウントは、ユーザーに対してアクセスを許可します。 次のいずれかの値を使用できます。
- GUID
- DN
- Domain\Account
- UPN
- LegacyExchangeDN
- SmtpAddress
- Alias
- $null
このパラメーターの値を $null に設定すると、アカウントのリンクが解除され、リンクされたメールボックスはリンクされていないユーザー メールボックスに変換されます。 メールボックスは、送信者、フル アクセス、フォルダー、およびカレンダー委任などの以前に設定されたアクセス許可を保持しません。
このパラメーターは、リンクされたユーザーに接続している場合にのみ必要です。
型: | UserIdParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MailboxRegion
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill MailboxRegion Description }}
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online |
-MailboxRegionSuffix
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill MailboxRegionSuffix Description }}
型: | MailboxRegionSuffixValue |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online |
-ManagedOnboardingType
このパラメーターは、クラウドベースのサービスでのみ使用できます。
{{ Fill ManagedOnboardingType Description }}
型: | ManagedOnboardingType |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-Manager
Manager パラメーターは、ユーザーのマネージャーを指定します。
型: | UserContactIdParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MobilePhone
MobilePhone パラメーターは、ユーザーの通常の携帯電話の番号を指定します。
注: Exchange Onlineでは、このパラメーターを使用することはできません。 代わりに、Microsoft Graph PowerShell の Update-MgUser コマンドレットで MobilePhone パラメーターを使用します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Name
Name パラメーターは、ユーザーの一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Notes
Notes パラメーターには、オブジェクトに関する追加情報を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Office
Office パラメーターは、ユーザーの事務所名または番号を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OtherFax
OtherFax パラメーターは、ユーザーの代りの FAX 番号を指定します。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OtherHomePhone
OtherHomePhone パラメーターは、ユーザーの代わりの自宅の電話番号を指定します。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OtherTelephone
OtherTelephone パラメーターは、ユーザーの代わりの電話番号を指定します。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Pager
Pager パラメーターは、ユーザーのポケットベル番号を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PermanentlyClearPreviousMailboxInfo
このパラメーターはクラウドベースのサービスでのみ使用できます。
PermanentlyClearPreviousMailboxInfo スイッチは、ユーザーのExchange Onlineメールボックス属性をクリアするかどうかを指定します。 このスイッチで値を指定する必要はありません。
これらの属性のクリアは、オンプレミスの Exchange と Microsoft 365 の間のメールボックスの移動と再ライセンスのシナリオで必要になる場合があります。 詳細については、「以前の メールボックス情報を完全にクリアする」を参照してください。
注意: このスイッチを使用すると、メールボックスに再接続できず、メールボックスからコンテンツを回復できなくなります。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Phone
Phone パラメーターは、ユーザーの事務所の電話番号を指定します。
注: Exchange Onlineでは、このパラメーターを使用することはできません。 代わりに、Microsoft Graph PowerShell の Update-MgUser コマンドレットで BusinessPhones パラメーターを使用します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PhoneticDisplayName
PhoneticDisplayName パラメーターは、ユニファイド メッセージング (UM) 環境で音声合成に使用される、ユーザーの名前の代替のスペルを指定します。 一般に、このパラメーターは、ユーザーの名前の発音とスペルが一致しない場合に使用します。 最大の長さは 256 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PostalCode
PostalCode パラメーターは、ユーザーの郵便番号を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PostOfficeBox
PostOfficeBox パラメーターは、ユーザーの私書箱の番号を指定します。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PublicFolder
PublicFolder スイッチは、パブリック フォルダー メールボックスを変更するために必要です。 このスイッチで値を指定する必要はありません。
パブリック フォルダー メールボックスは、パブリック フォルダーの階層と内容を保存する、特別に設計されたメールボックスです。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-RemotePowerShellEnabled
注: クラウドベースの環境では、このパラメーターは非推奨になっているため、代わりに EXOModuleEnabled パラメーターを使用してください。
RemotePowerShellEnabled パラメーターは、ユーザーが Exchange PowerShell にアクセスできるかどうかを指定します。 有効な値は次のとおりです。
- $true: ユーザーは、PowerShell、Exchange 管理シェル、Exchange 管理センター (EAC) Exchange Onlineアクセスできます。
- $false: ユーザーは、PowerShell、Exchange 管理シェル、または EAC Exchange Onlineアクセスできません。
既定値は、ユーザーに割り当てられている管理役割に応じて決まります。
Exchange PowerShell へのアクセスは、ローカルの Exchange サーバーで Exchange 管理シェルまたは EAC を開こうとしている場合でも必要です。
これらの管理インターフェイスのユーザー エクスペリエンスは、引き続き、ロールベースのアクセス制御 (RBAC) アクセス許可によって制御されます。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-RemoveMailboxProvisioningConstraint
このパラメーターは、クラウドベースのサービスでのみ使用できます。
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-ResetPasswordOnNextLogon
ResetPasswordOnNextLogon パラメーターには、ユーザーが次回のログオン時にパスワードを変更する必要があるかどうかを指定します。 有効な値は次のとおりです。
- $true: ユーザーは次回ログオン時にパスワードを変更する必要があります。
- $false: ユーザーは次回ログオン時にパスワードを変更する必要はありません。 これは既定の値です。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-SamAccountName
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
SamAccountName パラメーター (Windows 2000 より前のユーザー アカウントまたはグループ名とも呼ばれます) は、古いバージョンの Microsoft Windows クライアントおよびサーバー オペレーティング システムと互換性があるオブジェクト識別子を指定します。 値には、文字、数字、スペース、ピリオド (.)、および次の文字を含めることができます:!、#、$、%、^、&、-、_、{、}、~。 最後の文字をピリオドにすることはできません。 Unicode 文字は使用できますが、アクセント付き文字では競合が発生する可能性があります (たとえば、o と ö の一致)。 最大の長さは 20 文字です。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SeniorityIndex
SeniorityIndex パラメーターは、このユーザーが階層型アドレス帳で表示される順序を指定します。 値が 2 のユーザーは、値が 1 のユーザーよりもアドレス帳で上位に表示されます。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-SimpleDisplayName
SimpleDisplayName パラメーターは、使用できる文字が限定されている場合にオブジェクトの代替説明を表示するために使用されます。 使用できる文字は、次のとおりです。
- a から z
- A ~ Z
- 0 - 9
- スペース
" ' ( ) + , - . / : ?
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-SkipDualWrite
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
このパラメーターは、Microsoft の内部使用のために予約されています。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2016, Exchange Server 2019 |
-StateOrProvince
StateOrProvince パラメーターは、ユーザーの都道府県を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-StreetAddress
StreetAddress パラメーターは、ユーザーの住所を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-StsRefreshTokensValidFrom
このパラメーターは、クラウドベースのサービスでのみ使用できます。
StsRefreshTokensValidFrom は、ユーザーの STS 更新トークンが有効な日時を指定します。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。
型: | DateTime |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-TelephoneAssistant
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
TelephoneAssistant パラメーターは、ユーザーの秘書の電話番号を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Title
Title パラメーターは、ユーザーの役職を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-UMCallingLineIds
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
UMCallingLineIds パラメーターは、ユニファイド メッセージング (UM) が有効なユーザーにマップできる電話番号または拡張機能を指定します。 ユーザーごとに複数の電話番号をコンマで区切って指定できます。 このパラメーターは、長さが 128 文字未満の数字を受け取り、数値の前に省略可能なプラス記号 (+) を含めることができます。 UM が有効な各ユーザーには、一意の UMCallingLineIds パラメーター値が必要です。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UMDtmfMap
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
UMDtmfMap パラメーターは、受信者のデュアルトーン多重周波数 (DTMF) マップの値を指定します。 この指定により、ユニファイド メッセージング (UM) 環境で電話のキーパッドを使用して受信者を識別できます。 DTMF 値は通常自動的に作成されて更新されますが、このパラメーターを使用することにより手動で変更できます。 このパラメーターには、次の構文を使用します。
emailAddress:<integers>
lastNameFirstName:<integers>
firstNameLastName:<integers>
既存のすべてのエントリを上書きする値を入力するには、次の構文を使用します: emailAddress:<integers>,lastNameFirstName:<integers>,firstNameLastName:<integers>
。
この構文を使用して DTMF マップ値のいずれかを省略すると、それらの値が受信者から削除されます。 たとえば、 emailAddress:<integers>
のみを指定すると、既存のすべての lastNameFirstName 値と firstNameLastName 値が削除されます。
他の既存のエントリに影響を与えずに値を追加または削除するには、次の構文を使用します: @{Add="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"; Remove="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"}
。
この構文を使用する際は、DTMF マップ値をすべて指定する必要はなく、また複数の DTMF マップ値を指定することもできます。 たとえば、 @{Add="emailAddress:<integers1>","emailAddress:<integers2>}
を使用すると、既存の lastNameFirstName 値と firstNameLastName 値に影響を与えずに、emailAddress に 2 つの新しい値を追加できます。
型: | MultiValuedProperty |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UserPrincipalName
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
UserPrincipalName パラメーターは、ユーザー アカウントのログオン名を指定します。 UPN では、電子メール アドレス形式 ( username@domain
) が使用されます。 通常、domain の値は、ユーザー アカウントが存在するドメインです。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-VIP
このパラメーターは、クラウドベースのサービスでのみ使用できます。
VIP パラメーターは、ユーザーが優先順位アカウントであるかどうかを指定します。 有効な値は次のとおりです。
- $true: ユーザーは優先度アカウントです。
- $false: ユーザーは優先度アカウントではありません。
優先度アカウントの詳細については、「優先順位アカウントの 管理と監視」を参照してください。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Online, Exchange Online Protection |
-WebPage
WebPage パラメーターは、ユーザーの Web ページを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-WhatIf
WhatIf スイッチは、このコマンドレットでは機能しません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-WindowsEmailAddress
WindowsEmailAddress パラメーターは、この受信者の Windows 電子メール アドレスを指定します。 これは、すべての環境 (Exchange のない環境を含む) に存在する共通の Active Directory 属性です。 WindowsEmailAddress パラメーターを受信者に対して使用すると、次のいずれかの結果になります。
- 受信者がメール アドレス ポリシーの対象になる (その受信者に対して EmailAddressPolicyEnabled プロパティが値 True に設定されている) 環境では、WindowsEmailAddress パラメーターは WindowsEmailAddress プロパティまたはプライマリ メール アドレスの値に影響を与えません。
- 受信者がメール アドレス ポリシーの対象にならない (その受信者に対して EmailAddressPolicyEnabled プロパティが値 False に設定されている) 環境では、WindowsEmailAddress パラメーターは WindowsEmailAddress プロパティおよびプライマリ メール アドレスを同じ値に更新します。
WindowsEmailAddress プロパティは、[Active Directory ユーザーとコンピューター] の受信者に対して [電子メール] 属性で表示されます。 属性の共通名は E-mail-Addresses であり、Ldap-Display-Name は mail です。 この属性を Active Directory で変更した場合、受信者のプライマリ電子メール アドレスは同じ値に更新されません。
型: | SmtpAddress |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
適用対象: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。