Set-SiteMailbox
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
Set-SiteMailbox コマンドレットを使用して、Microsoft SharePoint URL などのサイト メールボックスの設定を変更します。 このコマンドレットは、主に SharePoint および Microsoft Exchange ユーザー インターフェイス (SharePoint URL など) によって使用されます。 このコマンドレットは、診断およびトラブルシューティングの目的のためにのみ使用してください。
サイト メールボックスは、2017 年に Exchange Online および SharePoint Online で非推奨になりました。 詳細については、「 サイト メールボックスの廃止」を参照してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-SiteMailbox
[-Identity] <RecipientIdParameter>
[-Active <Boolean>]
[-Confirm]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-Force]
[-Members <RecipientIdParameter[]>]
[-Owners <RecipientIdParameter[]>]
[-RemoveDuplicateMessages <Boolean>]
[-SharePointUrl <Uri>]
[-ShowInMyClient <Boolean>]
[-SyncEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-SiteMailbox -Identity "MarketingEvents 2013" -SharePointUrl "https://myserver/teams/marketing"
次の使用例は、MarketingEvents 2013 サイト メールボックスの SharePoint URL を変更します。
例 2
Set-SiteMailbox -Identity SMO_ContosoSales -RemoveDuplicateMessages $true
次の使用例は、SMO_ContosoSales サイトのメールボックス内の電子メール メッセージの複製を無効にします。
パラメーター
-Active
Active パラメーターでは、サイト メールボックスのライフサイクルのステータスを変更するかどうかを指定します。 このパラメーターには $true または $false を指定できます。 このパラメーターは、ユーザー インターフェイスでのみ使用するためのものです。 Exchange 管理シェルでは、このパラメーターを使用しないことをお勧めします。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 2013, Exchange Server 2016, Exchange Server 2019 |
-DisplayName
DisplayName パラメーターでは、サイト メールボックスの表示名を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity パラメーターは、サイト メールボックスの ID を指定します。 サイト メールボックスを一意に識別する任意の値を使用できます。 例:
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- 電子メール アドレス
- GUID
Type: | RecipientIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Members
このパラメーターは、ユーザー インターフェイスでのみ使用するためのものです。 このパラメーターは使用しないことをお勧めします。
Members パラメーターは、サイト メールボックスのメンバーを指定します。 このパラメーターを使用してメンバーを追加または削除できます。
メンバーを一意に識別する任意の値を使用できます。 例:
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- 電子メール アドレス
- GUID
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
Type: | RecipientIdParameter[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Owners
このパラメーターは、ユーザー インターフェイスでのみ使用するためのものです。 このパラメーターは使用しないことをお勧めします。
Owners パラメーターは、サイト メールボックスの所有者を指定します。 このパラメーターを使用して、所有者を追加または削除できます。
所有者を一意に識別する、任意の値を使用できます。 以下に例を示します。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- 電子メール アドレス
- GUID
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
Type: | RecipientIdParameter[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RemoveDuplicateMessages
RemoveDuplicateMessages パラメーターは、ユーザーがメッセージをサイト メールボックスに投稿した場合に、重複するメッセージを削除するように指定します。 このパラメーターに指定できる値は $true または $false です。 既定値は $false です。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SharePointUrl
SharePointUrl パラメーターは、SharePoint サイトの URL を指定します (例: "https://myserver/teams/edu")。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ShowInMyClient
このパラメーターは、ユーザー インターフェイスでのみ使用するためのものです。 このパラメーターは使用しないことをお勧めします。
ShowInMyClient パラメーターは、サイト メールボックス フォルダーを電子メール クライアントに表示することを指定します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SyncEnabled
SyncEnabled パラメーターは、サイト メールボックスの同期を有効または無効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: 同期が有効になっています。
- $true: 同期が無効になっています。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019 |
-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 2013, Exchange Server 2016, Exchange Server 2019 |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。