Set-Group

  • [アーティクル]

 

適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

トピックの最終更新日: 2009-05-12

既存の Microsoft Windows グループの設定を変更するには、Set-Group コマンドレットを使用します。

構文

Set-Group -Identity <GroupIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Group -Identity <GroupIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-Universal <SwitchParameter>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Group [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <WindowsGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-SimpleDisplayName <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

解説

Set-Group コマンドレットを使用すると、[Active Directory ユーザーとコンピュータ] に表示されるグループ オブジェクトの設定を変更できます。グループがメールの有効なセキュリティ グループまたは配布グループである場合は、Set-DistributionGroup コマンドレットを使用して、Set-Group コマンドレットでは不可能な Microsoft Exchange Server 2007 のその他の設定の変更が可能です。

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

Set-Group コマンドレットを実行するには、使用するアカウントに次の役割が委任されている必要があります。

  • Exchange 受信者管理者の役割
  • 該当する Active Directory コンテナのアカウント オペレータの役割

アクセス許可、役割の委任、および Exchange Server 2007 の管理に必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。

パラメータ

パラメータ 必須 種類 説明

Identity

必須

Microsoft.Exchange.Configuration.Tasks.GroupIdParameter

Identity パラメータには、変更するオブジェクトを指定します。Identity パラメータには、グループの次のいずれかの値を指定できます。

  • 識別名 (DN)
  • 正規名
  • GUID
  • 名前
  • 表示名

Instance パラメータを指定した場合、Identity は使用できません。

Confirm

省略可能

System.Management.Automation.SwitchParameter

Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。

DisplayName

省略可能

System.String

DisplayName パラメータには、Exchange 管理コンソールまたは Exchange グローバル アドレス一覧 (GAL) でのグループの名前を指定します。このパラメータは、グループのメールが有効である場合にのみ意味があります。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

この構成の変更を Active Directory に書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、DomainController パラメータを含めます。

IgnoreDefaultScope

省略可能

System.Management.Automation.SwitchParameter

IgnoreDefaultScope パラメータを指定すると、Exchange 管理シェルの受信者の範囲の既定の設定が無視され、範囲としてフォレスト全体が使用されます。これにより、現在既定の範囲にない Active Directory オブジェクトにアクセスすることができます。IgnoreDefaultScope パラメータを使用すると、次の制限が発生します。

  • DomainController パラメータは使用できません。このコマンドでは、適切なグローバル カタログ サーバーを自動的に使用します。
  • Identity パラメータの DN しか使用できません。エイリアスや GUID などの他の形式の ID は使用できません。

Instance

省略可能

Microsoft.Exchange.Data.Directory.Management.WindowsGroup

Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。

Identity パラメータを指定した場合、Instance パラメータは使用できません。

ManagedBy

省略可能

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

ManagedBy パラメータには、Active Directory オブジェクトの [管理] タブに表示されるユーザー、グループ、または連絡先の名前を指定します。このパラメータには次のいずれかの値を使用できます。

  • 識別名 (DN)
  • 正規名
  • GUID
  • 名前
  • 表示名

Name

省略可能

System.String

Name パラメータは、グループの名前を指定します。Name パラメータは、Active Directory ユーザーとコンピュータに表示されるグループ名、およびグループのメールが有効である場合は Exchange 管理コンソールの "グループ名" フィールドにも表示されるグループ名を指定します。

Notes

省略可能

System.String

Notes パラメータには、グループの目的を説明するメモを指定します。

PhoneticDisplayName

省略可能

System.String

PhoneticDisplayName パラメータには、DisplayName パラメータのふりがなを指定します。

このパラメータ値の長さは最大で 255 文字です。PhoneticDisplayName パラメータと音声認識の詳細については、「自動音声認識のディレクトリ参照について」を参照してください。

SimpleDisplayName

省略可能

System.String

SimpleDisplayName パラメータは、使用できる文字が限定されている場合にオブジェクトの代替説明を表示します。使用できる文字は、26 ～ 126 の範囲の ASCII 文字に限定されています。SimpleDisplayName は、メールが有効なオブジェクトについてのみ意味があります。

Universal

省略可能

System.Management.Automation.SwitchParameter

Universal パラメータは、グループのスコープを global または domain local から universal に変更します。

UseRusServer

省略可能

System.String
note注 :
このパラメータは Exchange 2007 SP2 でのみ使用できます。

UseRusServer パラメータを指定すると、このコマンドで、アドレス一覧サービスを実行している指定のメールボックス サーバーを使用してメールボックスと Active Directory ユーザー属性が取得され、それらが設定されるようになります。

アドレス一覧サービスは、Exchange System Attendant サービスのコンポーネントです。アドレス一覧サービスは、Active Directory において Exchange 固有の属性値を作成および管理します。アドレス一覧サービスを使用すると、アドレス一覧メンバシップや電子メール アドレスなどの特定の情報を使用して、ドメイン内の受信者オブジェクトを更新できます。

WhatIf

省略可能

System.Management.Automation.SwitchParameter

WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。

WindowsEmailAddress

省略可能

Microsoft.Exchange.Data.SmtpAddress

WindowsEmailAddress パラメータには、Active Directory オブジェクトの "電子メール" フィールドの値を指定します。

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例外

例外 説明

 

 

例

次のコード例は、Set-Group コマンドを使用して、Legal Department という名前の既存のグローバル セキュリティ グループに次の変更を適用する方法を示しています。

  • グループのスコープをユニバーサルに変更します。
  • verified という値のメモを追加します。
Set-Group -Identity "Legal Department" -Universal -Notes "verified"

参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。