Set-UMMailboxPIN
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
Set-UMMailboxPIN コマンドレットは、ユニファイド メッセージング (UM) が有効なメールボックスの PIN をリセットするために使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-UMMailboxPIN
[-Identity] <MailboxIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-IgnoreDefaultScope]
[-LockedOut <Boolean>]
[-NotifyEmail <String>]
[-Pin <String>]
[-PINExpired <Boolean>]
[-SendEmail <Boolean>]
[-WhatIf]
[<CommonParameters>]
説明
Set-UMMailboxPIN コマンドレットは、UM が有効なユーザーが正しくない PIN を使用して複数回ログオンを試みたため、または PIN を忘れたために、メールボックスからロックアウトされた場合に使用します。 このコマンドレットを使用してユーザーの PIN を設定できます。 新しい PIN は、ユーザーのメールボックス ポリシーに指定されている PIN ポリシーのルールに従っている必要があります。 新しい PIN は電子メール メッセージでユーザーに送信されるか、代替電子メール アドレスに送信されます。 管理者は、ユーザーがログオン時に PIN をリセットする必要があるかどうか、また、メールボックスが継続してロックアウトされるかどうかを制御できます。
このタスクが完了すると、UM が有効なメールボックスの PIN が設定されます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-UMMailboxPIN -Identity tonysmith@contoso.com
次の使用例は、 の UM 対応メールボックスの PIN をリセットします tonysmith@contoso.com。
例 2
Set-UMMailboxPIN -Identity tonysmith@contoso.com -PIN 1985848 -PinExpired $true
次の使用例は、最初の PIN を に対して UM 対応メールボックス tonysmith@contoso.comの1985848にリセットし、次にユーザーがログオンした際に PIN の変更を求められるように PIN を期限切れに設定します。
例 3
Set-UMMailboxPIN -Identity tonysmith@contoso.com -LockedOut $true
次の使用例は、 の UM 対応メールボックスを tonysmith@contoso.com ロックして、ユーザーがメールボックスにアクセスできないようにします。
例 4
Set-UMMailboxPIN -Identity tonysmith@contoso.com -LockedOut $false
次の使用例は、 の UM 対応メールボックスのロックを tonysmith@contoso.com 解除し、ユーザーがメールボックスにアクセスできるようにします。
パラメーター
-Confirm
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- 破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$false
を使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-DomainController
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Identity
Identity パラメーターは、変更するメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- Domain\Username
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
Type: | MailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-IgnoreDefaultScope
IgnoreDefaultScope スイッチは、Exchange PowerShell セッションに対する受信者の範囲の既定の設定を無視し、フォレスト全体を範囲として使用するようにコマンドに指示します。 このスイッチで値を指定する必要はありません。
このスイッチを使用すると、コマンドは、既定の範囲では現在使用できない Active Directory オブジェクトにアクセスできますが、次の制限もあります。
- DomainController パラメーターは使用できません。 このコマンドは、適切なグローバル カタログ サーバーを自動的に使用します。
- Identity パラメーターの DN しか使用できません。 エイリアスや GUID などの他の形式の ID は使用できません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-LockedOut
LockedOut パラメーターには、メールボックスを継続してロックアウトするかどうかを指定します。 $trueに設定すると、メールボックスはロックアウトとしてマークされます。既定では、このパラメーターを省略するか、$falseに設定すると、コマンドはメールボックスのロックアウト状態をクリアします。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-NotifyEmail
NotifyEmail パラメーターには、サーバーからの PIN リセット情報を含む電子メール メッセージの送信先となる電子メール アドレスを指定します。 既定では、有効なユーザーの SMTP アドレスに送信されます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-Pin
Pin パラメーターには、メールボックスで使用する新しい PIN を指定します。 指定した PIN は、ユニファイド メッセージング メールボックス ポリシーに定義された PIN ルールと比較して確認されます。 PIN を指定しない場合、このコマンドによってメールボックス用の新しい PIN が生成され、生成された PIN が、ユーザーに送信される電子メール メッセージに挿入されます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-PINExpired
PINExpired パラメーターは、PIN を期限切れとして扱うかどうかを指定します。 このパラメーターを指定して $false に設定すると、ユーザーは次回のログオン時に PIN のリセットを要求されません。 PIN を指定しない場合、PIN は期限切れとして扱われ、ユーザーは次回のログオン時に PIN をリセットするように求められます。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-SendEmail
SendEmail パラメーターには、電子メール メッセージで PIN をユーザーに送信するかどうかを指定します。 既定値は $true です。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016 |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。