Set-Group

 

適用先:Exchange Online, Exchange Server 2016

トピックの最終更新日:2016-04-06

このコマンドレットは、社内の Exchange Server 2016 とクラウド ベースのサービスとで使用可能です。一部のパラメーターや設定は、いずれかの環境に専用であることがあります。

Set-Group コマンドレットを使用して、グループ オブジェクトの設定を変更します。グループがメールの有効なセキュリティ グループまたは配布グループである場合は、Set-DistributionGroup コマンドレットを使用することにより、Set-Group コマンドレットでは不可能なその他の Microsoft Exchange の設定を変更できます。

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

Set-Group -Identity <GroupIdParameter> <COMMON PARAMETERS>

Set-Group -Identity <GroupIdParameter> [-Universal <SwitchParameter>] <COMMON PARAMETERS>

COMMON PARAMETERS: [-BypassSecurityGroupManagerCheck <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-IsHierarchicalGroup <$true | $false>] [-ManagedBy <GeneralRecipientIdParameter[]>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SeniorityIndex <Int32>] [-SimpleDisplayName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

この例は、以下の変更を Legal Department という既存のグローバル セキュリティ グループに適用します。

  • グループのスコープをユニバーサルに変更します。

  • Notes パラメーターの確認済みの値を追加します。

Set-Group -Identity "Legal Department" -Universal -Notes "verified"

この例は、グループ Human Resources が階層型グループで、そのインデックス番号が 1 であるため、階層内の最後に表示されることを示します。

Set-Group -Identity "Human Resources" -IsHierarchicalGroup $true -SeniorityIndex 1

Set-Group コマンドレットを使用して、動的配布グループを変更することはできません。動的配布グループを変更するには、Set-DynamicDistributionGroup コマンドレットを使用します。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが示されていますが、割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。必要なアクセス許可の一覧については、以下を参照してください。「受信者のアクセス許可」の「配布グループ」。

 

パラメーター 必須 種類 説明

Identity

必須

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

Identity パラメーターは、変更するグループを指定します。グループを一意に識別する任意の値を使用できます。

以下に例を示します。

  • 名前

  • 表示名

  • 識別名 (DN)

  • 正規 DN

  • GUID

BypassSecurityGroupManagerCheck

省略可能

System.Management.Automation.SwitchParameter

BypassSecurityGroupManagerCheck スイッチは、グループの所有者ではないユーザーにそのグループの変更または削除を許可するかどうかを指定します。ユーザーがグループの ManagedBy プロパティで定義されていない場合、そのユーザーは、そのグループを変更または削除するコマンドでこのスイッチを使用する必要があります。このスイッチを使用するには、アカウントに、次のようなグループの種類に基づく特定のアクセス許可が必要になります。

  • 配布グループまたはメールが有効なセキュリティ グループ ユーザーは Organization Management 役割グループのメンバーであるか、Security Group Creation and Membership の役割が割り当てられている必要があります。

  • 役割グループ ユーザーは Organization Management 役割グループのメンバーであるか、Role Management の役割が割り当てられている必要があります。

このスイッチで値を指定する必要はありません。

Confirm

省略可能

System.Management.Automation.SwitchParameter

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

  • データを破壊するコマンドレット (たとえば、Remove-* コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、この構文 (-Confirm:$false) 正しくを使用すると確認のメッセージを省略できます。

  • 他のほとんどのコマンドレット (たとえば、New-*Set-* コマンドレット) には、組み込みの一時停止はありません。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

DisplayName

省略可能

System.String

DisplayName パラメーターは、グループの表示名を指定します。表示名は、Exchange 管理センターとアドレス一覧に表示されます。最大の長さは 256 文字です。値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

このパラメーターは、グループのメールが有効である場合にのみ意味があります。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

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

DomainController パラメーターでは、このコマンドレットが Active Directory との間でデータの読み書きをするために使用するドメイン コントローラーを指定します。ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。たとえば、dc01.contoso.com などです。

DomainController パラメーターは、エッジ トランスポート サーバーではサポートされていません。エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。

IgnoreDefaultScope

省略可能

System.Management.Automation.SwitchParameter

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

IgnoreDefaultScope スイッチは、Exchange 管理シェル セッションに対する受信者の範囲の既定の設定を無視し、フォレスト全体を範囲として使用するようにコマンドに指示します。このスイッチによって、コマンドは、既定の範囲では現在使用できない Active Directory オブジェクトにアクセスできます。

IgnoreDefaultScope スイッチを使用すると、次の制限が発生します。

  • DomainController パラメーターは使用できません。このコマンドは、適切なグローバル カタログ サーバーを自動的に使用します。

  • Identity パラメーターには DN のみを使用できます。エイリアスや GUID などの他の形式の ID は使用できません。

IsHierarchicalGroup

省略可能

System.Boolean

IsHierarchicalGroup パラメーターは、グループが階層型アドレス帳の一部であるかどうかを指定します。正しい値は $true または $false です。既定値は $false です。

ManagedBy

省略可能

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter[]

ManagedBy パラメーターには、グループの所有者を指定します。グループには、最低 1 人の所有者が必要です。グループの作成時に、このパラメーターを使用せずに所有者を指定した場合、そのグループを作成したユーザー アカウントはその所有者です。グループの所有者は、次の操作を実行できます。

  • グループのプロパティを変更する

  • グループのメンバーを追加または削除する

  • グループを削除する

  • メンバーの退会要求または参加要求を承認する (可能な場合)

  • モデレートが有効になっているがモデレーターが指定されていない場合に、グループに送信されたメッセージを承認する。

このパラメーターに指定する所有者は、メールボックス、メール ユーザー、またはメールが有効なセキュリティ グループ (アクセス許可を割り当てることができる、メールが有効なセキュリティ プリンシパル) である必要があります。所有者を一意に識別する、任意の値を使用できます。以下に例を示します。

  • 名前

  • 表示名

  • エイリアス

  • 識別名 (DN)

  • 正規 DN

  • <domain name>\<account name>

  • 電子メール アドレス

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • ユーザー ID またはユーザー プリンシパル名 (UPN)

複数の所有者を入力して既存のエントリをすべて上書きするには、次の構文を使用します: <owner1>,<owner2>...。値にスペースが含まれている場合や引用符が必要な場合は、次の構文を使用する必要があります: "<owner1>","<owner2>"...

既存の他のエントリに影響を与えずに所有者を追加または削除するには、次の構文を使用します: @{Add="<owner1>","<owner2>"...; Remove="<owner3>","<owner4>"...}

このパラメーターで指定した所有者は、自動的にはグループのメンバーになりません。この所有者をメンバーとして手動で追加する必要があります。

Name

省略可能

System.String

Name パラメーターは、グループの一意の名前を指定します。最大の長さは 64 文字です。値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

Notes

省略可能

System.String

Notes パラメーターには、オブジェクトに関する追加情報を指定します。値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

PhoneticDisplayName

省略可能

System.String

PhoneticDisplayName パラメーターは、ユニファイド メッセージング (UM) 環境で音声合成に使用される、ユーザーの名前の代替のスペルを指定します。一般に、このパラメーターは、ユーザーの名前の発音とスペルが一致しない場合に使用します。最大の長さは 256 文字です。値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

SeniorityIndex

省略可能

System.Int32

SeniorityIndex パラメーターには、このグループが階層型アドレス帳に表示される順番を指定します。値が 2 のグループは、値が 1 のグループよりも上位の順番でアドレス帳に表示されます。

SimpleDisplayName

省略可能

System.String

SimpleDisplayName パラメーターは、使用できる文字が限定されている場合にオブジェクトの代替説明を表示するために使用されます。使用できる文字は次のとおりです。

  • a ~ z

  • A ~ Z

  • 0 - 9

  • "<space>"、"""、"'"、"("、")"、"+"、","、"-"、"."、"/"、":"、"?"。

このパラメーターは、グループのメールが有効である場合にのみ意味があります。

Universal

省略可能

System.Management.Automation.SwitchParameter

Universal スイッチは、グループのスコープを Global または DomainLocal から Universal に変更します。このスイッチで値を指定する必要はありません。

WhatIf

省略可能

System.Management.Automation.SwitchParameter

WhatIf スイッチは、コマンドの操作をシミュレートします。このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。このスイッチに値を指定する必要はありません。

WindowsEmailAddress

省略可能

Microsoft.Exchange.Data.SmtpAddress

WindowsEmailAddress パラメーターは、この受信者の Windows のメール アドレスを指定します。これは、すべての環境 (Exchange のない環境を含む) に存在する共通の Active Directory 属性です。WindowsEmailAddress パラメーターを受信者に対して使用すると、次のいずれかの結果になります。

  • 受信者がメール アドレス ポリシーの対象になる (その受信者に対して EmailAddressPolicyEnabled プロパティが値 True に設定されている) オンプレミス環境では、WindowsEmailAddress パラメーターは WindowsEmailAddress プロパティまたはプライマリ メール アドレスの値に影響を与えません。

  • 受信者がメール アドレス ポリシーの対象ではない (その受信者に対して EmailAddressPolicyEnabled プロパティが値 False に設定されている) クラウド環境またはオンプレミス環境では、WindowsEmailAddress パラメーターによって WindowsEmailAddress プロパティおよびプライマリ メール アドレスが同じ値に更新されます。

WindowsEmailAddress プロパティは、[Active Directory ユーザーとコンピューター] の受信者に対して [電子メール] 属性で表示されます。属性の共通名は E-mail-Addresses であり、Ldap-Display-Namemail です。この属性を Active Directory で変更した場合、受信者のプライマリ メール アドレスは同じ値に更新されません。

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

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

 
表示: