Set-GlobalAddressList (RTM)
适用于: Exchange Server 2007
上一次修改主题: 2007-06-05
使用 Set-GlobalAddressList cmdlet 可以在 Active Directory 目录服务中修改全局地址列表 (GAL) 的属性。
语法
Set-GlobalAddressList -Identity <GlobalAddressListIdParameter> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>]
Set-GlobalAddressList [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <GlobalAddressList>] [-Name <String>] [-RecipientFilter <String>]
详细说明
Set-GlobalAddressList cmdlet 修改 GAL 中的属性。
若要运行 Set-GlobalAddressList cmdlet,必须为您使用的帐户委派以下角色:
- Exchange 组织管理员角色
有关管理 Exchange Server 2007 所需的权限、角色委派以及权利的详细信息,请参阅权限注意事项。
参数
参数 | 必需 | 类型 | 说明 |
---|---|---|---|
Identity |
必需 |
Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter |
使用 Identity 参数指定代表特定全局地址列表 (GAL) 的 GUID、可分辨名称或 GAL 名称。还可以包含采用 Path\GlobalAddressListName 格式的路径。 可以省略参数标签 Identity,以便只提供 GAL 名称或 GUID。 |
ConditionalCompany |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCompany 参数用于指定公司。可以使用以逗号分隔的多个值。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute1 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute10 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute11 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute12 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute13 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute14 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute15 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute2 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute3 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute4 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute5 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute6 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute7 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute8 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalCustomAttribute9 |
可选 |
System.String |
此参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
ConditionalDepartment |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalDepartment 参数用于指定部门。将包括其部门属性与为此参数所输入的值相匹配的所有 GAL。可以使用以逗号分隔的多个值。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定将此配置更改写入 Active Directory 域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。 |
ForceUpgrade |
可选 |
System.Management.Automation.SwitchParameter |
ForceUpgrade 参数禁用以下确认:“若要保存对对象的更改,必须将该对象升级到当前的 Exchange 版本。完成升级后,无法通过早期版本的 Exchange 系统管理器管理来此对象。要继续升级并保存该对象吗?”在升级 Microsoft Exchange Server 2003 或 Exchange 2000 Server 中创建的 GAL 时会出现此确认消息。在更新对象版本并使用 RecipientFilter 或 IncludedRecipients 参数更改收件人筛选器之前,无法使用 Exchange 管理控制台管理 Exchange 2003 或 Exchange 2000 GAL。 |
IncludedRecipients |
可选 |
System.Nullable |
IncludedRecipients 参数可以筛选用于构建 GAL 的收件人类型。IncludedRecipients 参数的可用值为 AllRecipients、MailboxUsers、Resources、Contacts 和 MailGroups。 AllRecipients 值只能单独使用。当 IncludedRecipients 参数的多个值使用逗号分隔时,将应用 OR 布尔运算符。 如果使用任何 Conditional 参数,则必须使用此参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
Instance |
可选 |
Microsoft.Exchange.Data.Directory.Management.GlobalAddressList |
使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。 |
Name |
可选 |
System.String |
无。 |
RecipientFilter |
可选 |
System.String |
RecipientFilter 参数指定要包括在 GAL 中的收件人的筛选器。如果使用任何以下筛选器参数,则不能使用此参数:
必须使用此参数,或上面列出的筛选器参数之一。 有关可筛选属性的详细信息,请参阅 -RecipientFilter 参数的可筛选属性。 |
ConditionalStateOrProvince |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
无。 |
输入类型
返回类型
错误
错误 | 说明 |
---|---|
|
异常
异常 | 说明 |
---|---|
|
示例
在此示例中,使用 Set-GlobalAddressList 命令向 GUID 为 96d0c505-eba8-4103-ad4f-577a1bf4ad7b 的 GAL 指定新名称 GALwithNewName。
Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName