Set-Contact (RTM)
適用先: Exchange Server 2007
トピックの最終更新日: 2007-06-17
Set-Contact コマンドレットを使用して、既存の連絡先の設定を変更します。
構文
Set-Contact -Identity <ContactIdParameter> [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-Initials <String>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-WebPage <String>]
Set-Contact [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-Initials <String>] [-Instance <Contact>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-WebPage <String>]
解説
Set-Contact コマンドレットを使用すると、[Active Directory ユーザーとコンピュータ] に表示される連絡先オブジェクトの設定を変更できます。連絡先のメールが有効な場合、Set-MailContact コマンドレットを使用すると、Set-Contact コマンドレットでは変更できない連絡先の電子メール設定を変更できます。Set-MailContact コマンドレットの詳細については、「Set-MailContact (RTM)」を参照してください。
Set-Contact コマンドレットを実行するには、使用するアカウントに次の役割が委任されている必要があります。
- Exchange 受信者管理者の役割
- 該当する Active Directory コンテナのアカウント オペレータの役割
Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
パラメータ | 必須かどうか | 種類 | 説明 |
---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Configuration.Tasks.ContactIdParameter |
Identity パラメータには、変更するオブジェクトを指定します。Identity パラメータには、連絡先オブジェクトを表す次のいずれかの値を指定できます。
Instance パラメータを指定した場合、Identity パラメータは使用できません。 |
AssistantName |
省略可能 |
System.String |
AssistantName パラメータには、連絡先のアシスタントの名前を指定します。 |
City |
省略可能 |
System.String |
City パラメータには、連絡先の市町村を指定します。 |
Company |
省略可能 |
System.String |
Company パラメータには、連絡先の会社を指定します。 |
CountryOrRegion |
省略可能 |
Microsoft.Exchange.Data.Directory.CountryInfo |
CountryOrRegion パラメータには、連絡先の国または地域を指定します。 |
CreateDTMFMap |
省略可能 |
System.Boolean |
このパラメータには、連絡先のデュアル トーン多重周波数 (DTMF) マップを作成することを指定します。 |
Department |
省略可能 |
System.String |
Department パラメータには、連絡先の部署を指定します。 |
DisplayName |
省略可能 |
System.String |
DisplayName パラメータを使用すると、Exchange 管理コンソールおよび Exchange グローバル アドレス一覧 (GAL) に連絡先の名前を指定できます。DisplayName は、メールが有効なオブジェクトについてのみ意味があります。 |
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、DomainController パラメータを含めます。 |
Fax |
省略可能 |
System.String |
Fax パラメータには、連絡先の FAX 番号を指定します。 |
FirstName |
省略可能 |
System.String |
FirstName パラメータには、連絡先の名を指定します。 |
HomePhone |
省略可能 |
System.String |
HomePhone パラメータには、連絡先の自宅の電話番号を指定します。 |
Initials |
省略可能 |
System.String |
Initials パラメータには、連絡先の名前のイニシャルを指定します。 |
Instance |
省略可能 |
Microsoft.Exchange.Data.Directory.Management.Contact |
Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。 Identity パラメータを指定した場合、Instance パラメータは使用できません。 |
LastName |
省略可能 |
System.String |
LastName パラメータには、連絡先の姓を指定します。 |
Manager |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter |
Manager パラメータには、連絡先の上司を指定します。 |
MobilePhone |
省略可能 |
System.String |
MobilePhone パラメータには、連絡先の主要なモバイル機器の番号を指定します。 |
Name |
省略可能 |
System.String |
Name パラメータには、[Active Directory ユーザーとコンピュータ] の連絡先の名前、およびグループのメールが有効な場合は Exchange 管理コンソールの "グループ名" フィールドの連絡先の名前を指定します。 Name の値は、64 文字以下にする必要があります。 |
Notes |
省略可能 |
System.String |
Notes パラメータには、連絡先に関する追加情報を指定します。 |
Office |
省略可能 |
System.String |
Office パラメータには、連絡先の事務所名または番号を指定します。 |
OtherFax |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
OtherFax パラメータには、連絡先の代替 FAX 番号を指定します。 |
OtherHomePhone |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
OtherHomePhone パラメータには、連絡先の自宅の代替電話番号を指定します。 |
OtherTelephone |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
OtherTelephone パラメータには、連絡先の勤務先の代替電話番号を指定します。 |
Pager |
省略可能 |
System.String |
Pager パラメータには、連絡先のポケットベル番号を指定します。 |
Phone |
省略可能 |
System.String |
Phone パラメータには、連絡先の勤務先の電話番号を指定します。 |
PhoneticDisplayName |
省略可能 |
System.String |
PhoneticDisplayName パラメータには、DisplayName パラメータのふりがなを指定します。 このパラメータ値の長さは最大で 255 文字です。PhoneticDisplayName パラメータと音声認識の詳細については、「自動音声認識のディレクトリ参照について」を参照してください。 |
PostalCode |
省略可能 |
System.String |
PostalCode パラメータには、連絡先の郵便番号を指定します。 |
PostOfficeBox |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
PostOfficeBox パラメータには、連絡先の私書箱の番号を指定します。 |
SimpleDisplayName |
省略可能 |
System.String |
SimpleDisplayName パラメータは、使用できる文字が限定されている場合にオブジェクトの代替説明を表示するために使用されます。使用できる文字は、26 ~ 126 の範囲の ASCII 文字に限定されています。SimpleDisplayName は、メールが有効なオブジェクトについてのみ意味があります。 |
StateOrProvince |
省略可能 |
System.String |
StateOrProvince パラメータには、連絡先の都道府県を指定します。 |
StreetAddress |
省略可能 |
System.String |
StreetAddress パラメータには、連絡先の住所を指定します。 |
TelephoneAssistant |
省略可能 |
System.String |
TelephoneAssistant パラメータには、連絡先のアシスタントの電話番号を指定します。 |
Title |
省略可能 |
System.String |
Title パラメータには、連絡先の役職を指定します。 |
UMDialPlan |
省略可能 |
Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter |
このパラメータには、ダイヤル プランのディレクトリ オブジェクト ID を指定します。 |
UMDtmfMap |
省略可能 |
Microsoft.Exchange.Data.MultiValuedProperty |
このパラメータには、UM が有効な連絡先のユーザー定義 DTMF マップを作成するかどうかを指定します。 |
WebPage |
省略可能 |
System.String |
WebPage パラメータには、連絡先の Web ページを指定します。 |
入力の種類
戻り値の種類
エラー
エラー | 説明 |
---|---|
|
|
例外
例外 | 説明 |
---|---|
|
|
例
Set-Contact コマンドを使用して、contoso.com という Active Directory ドメインの Users コンテナで、Ted Bremer という名前の既存の連絡先を、どのように変更させるか次のコード例で示しています。
- City の値を Seattle に変更します
- Company の値を Contoso に変更します
Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。