Set-PublicFolder

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。

パブリック フォルダーの属性を設定するには、Set-PublicFolder コマンドレットを使用します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Set-PublicFolder
   [-Identity] <PublicFolderIdParameter>
   [-AgeLimit <EnhancedTimeSpan>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-EformsLocaleId <CultureInfo>]
   [-Force]
   [-HiddenFromAddressListsEnabled <Boolean>]
   [-IssueWarningQuota <Unlimited>]
   [-LocalReplicaAgeLimit <EnhancedTimeSpan>]
   [-MailRecipientGuid <Guid>]
   [-MailEnabled <Boolean>]
   [-MaxItemSize <Unlimited>]
   [-Name <String>]
   [-OverrideContentMailbox <MailboxIdParameter>]
   [-Path <PublicFolderIdParameter>]
   [-PerUserReadStateEnabled <Boolean>]
   [-ProhibitPostQuota <Unlimited>]
   [-Replicas <DatabaseIdParameter[]>]
   [-ReplicationSchedule <Schedule>]
   [-RetainDeletedItemsFor <EnhancedTimeSpan>]
   [-Server <ServerIdParameter>]
   [-UseDatabaseAgeDefaults <Boolean>]
   [-UseDatabaseQuotaDefaults <Boolean>]
   [-UseDatabaseReplicationSchedule <Boolean>]
   [-UseDatabaseRetentionDefaults <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

説明

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Set-PublicFolder "\Customer Service Requests" -UseDatabaseReplicationSchedule $false

Exchange 2010 では、この例では、データベースの既定のレプリケーション スケジュールを使用しないようにパブリック フォルダーを変更します。

例 2

Set-PublicFolder "\Customer Service Requests" -OverrideContentMailbox North_America

この例では、パブリック フォルダー階層メールボックスのコンテンツの場所を North_America に変更します。

例 3

Set-PublicFolder \MyPublicFolder -ReplicationSchedule "Saturday.12:00 AM-Monday.12:00 AM"

Exchange 2010 では、この例では、フォルダーを週末にのみレプリケートするように設定します。

パラメーター

-AgeLimit

AgeLimit パラメーターには、フォルダーの全体的な保存期間を指定します。 このパブリック フォルダーのレプリカは、保存期間を超えた時点で自動的に削除されます。

値を指定するには、dd.hh:mm:ss の形式で期間として入力します。ここで、dd = 日、hh = 時間、mm = 分、ss = 秒です。

Type:EnhancedTimeSpan
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, Exchange Server 2019, Exchange Online

-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, Exchange Server 2019, Exchange Online

-DomainController

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

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, Exchange Server 2019

-EformsLocaleId

EformsLocaleId パラメーターには、ロケール固有のバージョンの電子フォーム ライブラリを指定します。 EformsLocaleId パラメーターの有効な入力は、CultureInfo クラスで使用できる .NET クラス ライブラリ クラス参照Microsoftの [カルチャ名] 列に一覧表示される文字列名です。

Type:CultureInfo
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, Exchange Server 2019, Exchange Online

-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, Exchange Online

-HiddenFromAddressListsEnabled

このパラメーターは Exchange Server 2010 でのみ使用できます。

HiddenFromAddressListsEnabled パラメーターは、パブリック フォルダーをアドレス一覧から非表示にするかどうかを指定します。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-Identity

Identity パラメーターは、変更するパブリック フォルダーの名前とパスを指定します。 有効な値には、 という形式が使用されます \Level1\Level2\...\LevenN\PublicFolder。 たとえば、"\Customer Discussion" および "\Engineering\Customer Discussion" が禁止となります。

Type:PublicFolderIdParameter
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, Exchange Server 2019, Exchange Online

-IssueWarningQuota

IssueWarningQuota パラメーターは、パブリック フォルダーの所有者にフォルダーがほぼいっぱいになったことを示す警告を発行するときのパブリック フォルダーのサイズを指定します。

既定値は unlimited です。つまり、2 テラバイトになります。

値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。

  • B (バイト)
  • KB (キロバイト)
  • MB (メガバイト)
  • GB (ギガバイト)
  • TB (テラバイト)

通常、単位なしの値はバイトとして扱われますが、小さい値は最も近いキロバイトの値に切り上げられます。

このパラメーターの有効な入力の範囲は、1 ～ 2TB です。

Type:Unlimited
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, Exchange Server 2019, Exchange Online

-LocalReplicaAgeLimit

このパラメーターは、Exchange Server 2010 でのみ使用できます

LocalReplicaAgeLimit パラメーターは、接続されたサーバー上にレプリカがある場合のレプリカの有効期間を指定します。

Type:EnhancedTimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-MailEnabled

MailEnabled パラメーターは、パブリック フォルダーでメールを有効にするかどうかを指定します。 有効にするには、値 $true を使用します。

このパラメーターは、メールが有効な状態が失われているメール有効パブリック フォルダーを修正する場合に使用します。 メール有効に設定されたことがないパブリック フォルダーのメールを有効にするためにこのパラメーターを使用すると、コマンドが失敗します。

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, Exchange Online

-MailRecipientGuid

MailRecipientGuid パラメーターは、パブリック フォルダーの MailRecipientGuid 値を指定します。 このパラメーターは、MailRecipientGuid 値が失われているメール有効パブリック フォルダーを修正する場合に使用します。

このパラメーターに指定する値は、既存のメールが有効なパブリック フォルダーの MailRecipientGuid 値と一致する必要があります。 使用しない場合、コマンドは失敗します。

Type:Guid
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, Exchange Online

-MaxItemSize

MaxItemSize パラメーターは、投稿されたアイテムの最大サイズを指定します。 MaxItemSize パラメーターの値より大きい項目は拒否されます。 既定値は無制限で、2 ギガバイトです。 値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。

値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。

  • B (バイト)
  • KB (キロバイト)
  • MB (メガバイト)
  • GB (ギガバイト)
  • TB (テラバイト)

通常、単位なしの値はバイトとして扱われますが、小さい値は最も近いキロバイトの値に切り上げられます。

このパラメーターの有効な入力の範囲は、1 ～ 2GB です。

Type:Unlimited
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, Exchange Server 2019, Exchange Online

-Name

Name パラメーターには、パブリック フォルダーの名前を指定します。

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, Exchange Server 2019, Exchange Online

-OverrideContentMailbox

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

OverrideContentMailbox パラメーターは、このパブリック フォルダーのコンテンツを移動するターゲット パブリック フォルダー メールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • Domain\Username
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (UPN)
Type:MailboxIdParameter
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

-Path

Path パラメーターは、パブリック フォルダーのパスを指定します。たとえば、\TopLevelPublicFolder\PublicFolder です。

Type:PublicFolderIdParameter
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, Exchange Online

-PerUserReadStateEnabled

PerUserReadStateEnabled パラメーターは、既読および未読のデータを維持するかどうかをユーザーごとに指定します。

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, Exchange Server 2019, Exchange Online

-ProhibitPostQuota

ProhibitPostQuota パラメーターは、パブリック フォルダーがいっぱいであることをユーザーに通知するパブリック フォルダーのサイズを指定します。 ユーザーは、サイズが ProhibitPostQuota パラメーター値よりも大きいフォルダーに投稿できません。 既定値は unlimited です。つまり、2 テラバイトになります。

値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。

  • B (バイト)
  • KB (キロバイト)
  • MB (メガバイト)
  • GB (ギガバイト)
  • TB (テラバイト)

通常、単位なしの値はバイトとして扱われますが、小さい値は最も近いキロバイトの値に切り上げられます。

このパラメーターの有効な入力の範囲は、1 ～ 2TB です。

Type:Unlimited
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, Exchange Server 2019, Exchange Online

-Replicas

このパラメーターは、Exchange Server 2010 でのみ使用できます

レプリカ パラメーターは、このパブリック フォルダーをレプリケートするパブリック フォルダー データベースの一覧を指定します。 データベースを一意に識別する、任意の値を使用できます。 以下に例を示します。

  • 名前
  • 識別名 (DN)
  • GUID

複数の値をコンマで区切って指定できます。 値にスペースが含まれている場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

Type:DatabaseIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-ReplicationSchedule

このパラメーターは、Exchange Server 2010 でのみ使用できます

ReplicationSchedule パラメーターは、フォルダーのレプリケーション スケジュールを指定します。

このパラメーターの構文は です。 StartDay.Hour:Minute [AM | PM]-EndDay.Hour:Minute [AM | PM]

日数は次の値を使用できます。

  • その日のフル ネーム。
  • 日付の省略名。
  • 0 から 6 までの整数 。0 = 日曜日。

時刻を 24 時間形式で入力し、AM/PM 値を省略できます。 時刻を 12 時間形式で入力する場合は、時刻と AM/PM 値の間にスペースを含めます。

日付/時刻形式を混在させ、一致させることができます。

開始時刻と終了時刻は 15 分以上離れている必要があります。 分は 0、15、30、または 45 に切り捨てられます。

次に、いくつかの例を示します:

  • "Sun.11:30 PM-Mon.1:30 AM"
  • "6.22:00-6.22:15" (土曜日の午後 10:00 から土曜日の午後 10:15 まで実行されます。
  • "Sun.1:15 AM-Monday.23:00"
Type:Schedule
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-RetainDeletedItemsFor

RetainDeletedItemsFor パラメーターは、削除済みアイテムを保持する期間を指定します。

値を指定するには、dd.hh:mm:ss の形式で期間として入力します。ここで、dd = 日、hh = 時間、mm = 分、ss = 秒です。

Type:EnhancedTimeSpan
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, Exchange Server 2019, Exchange Online

-Server

このパラメーターは、Exchange Server 2010 でのみ使用できます

Server パラメーターは、このコマンドの実行先となる Exchange サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • FQDN
  • 識別名 (DN)
  • Exchange の従来の DN

このパラメーターを使用しない場合、コマンドはローカル サーバー上で実行されます。

Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-UseDatabaseAgeDefaults

このパラメーターは、Exchange Server 2010 でのみ使用できます

UseDatabaseAgeDefaults パラメーターは、データベースの有効期間制限を使用するかどうかを指定します。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-UseDatabaseQuotaDefaults

このパラメーターは、Exchange Server 2010 でのみ使用できます

UseDatabaseQuotaDefaults パラメーターは、パブリック ストアクォータ制限を使用するかどうかを指定します。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-UseDatabaseReplicationSchedule

このパラメーターは、Exchange Server 2010 でのみ使用できます

UseDatabaseReplicationSchedule パラメーターは、パブリック フォルダー レプリケーション スケジュールを使用するかどうかを指定します。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-UseDatabaseRetentionDefaults

このパラメーターは、Exchange Server 2010 でのみ使用できます

UseDatabaseRetentionDefaults パラメーターは、データベース保持の既定値を使用するかどうかを指定します。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-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, Exchange Server 2019, Exchange Online

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。