Set-UnifiedGroup
此指令程式只能在雲端式服務中使用。
使用 Set-UnifiedGroup Cmdlet 來修改雲端式組織中的Microsoft 365 群組。 若要修改Microsoft 365 群組的成員、擁有者和訂閱者,請使用 Add-UnifiedGroupLinks 和 Remove-UnifiedGroupLinks Cmdlet。
重要:您無法使用此 Cmdlet 從 Microsoft 365 群組移除所有 Microsoft Online Email路由位址 (MOERA) 位址。 至少必須有一個 MOERA 位址附加至群組。 若要深入瞭解 MOERA 位址,請參閱 如何在 Azure AD 中填入 proxyAddresses 屬性。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
Set-UnifiedGroup
[-Identity] <UnifiedGroupIdParameter>
[-AcceptMessagesOnlyFromSendersOrMembers <MultiValuedProperty>]
[-AccessType <ModernGroupTypeInfo>]
[-Alias <String>]
[-AlwaysSubscribeMembersToCalendarEvents]
[-AuditLogAgeLimit <EnhancedTimeSpan>]
[-AutoSubscribeNewMembers]
[-CalendarMemberReadOnly]
[-Classification <String>]
[-Confirm]
[-ConnectorsEnabled]
[-CustomAttribute1 <String>]
[-CustomAttribute10 <String>]
[-CustomAttribute11 <String>]
[-CustomAttribute12 <String>]
[-CustomAttribute13 <String>]
[-CustomAttribute14 <String>]
[-CustomAttribute15 <String>]
[-CustomAttribute2 <String>]
[-CustomAttribute3 <String>]
[-CustomAttribute4 <String>]
[-CustomAttribute5 <String>]
[-CustomAttribute6 <String>]
[-CustomAttribute7 <String>]
[-CustomAttribute8 <String>]
[-CustomAttribute9 <String>]
[-DataEncryptionPolicy <DataEncryptionPolicyIdParameter>]
[-DisplayName <String>]
[-EmailAddresses <ProxyAddressCollection>]
[-ExtensionCustomAttribute1 <MultiValuedProperty>]
[-ExtensionCustomAttribute2 <MultiValuedProperty>]
[-ExtensionCustomAttribute3 <MultiValuedProperty>]
[-ExtensionCustomAttribute4 <MultiValuedProperty>]
[-ExtensionCustomAttribute5 <MultiValuedProperty>]
[-ForceUpgrade]
[-GrantSendOnBehalfTo <MultiValuedProperty>]
[-HiddenFromAddressListsEnabled <Boolean>]
[-HiddenFromExchangeClientsEnabled]
[-InformationBarrierMode <GroupInformationBarrierMode>]
[-IsMemberAllowedToEditContent <System.Boolean>]
[-Language <CultureInfo>]
[-MailboxRegion <String>]
[-MailTip <String>]
[-MailTipTranslations <MultiValuedProperty>]
[-MaxReceiveSize <Unlimited>]
[-MaxSendSize <Unlimited>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-Notes <String>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RejectMessagesFromSendersOrMembers <MultiValuedProperty>]
[-RequireSenderAuthenticationEnabled <Boolean>]
[-SensitivityLabelId <Sustem.Guid>]
[-SubscriptionEnabled]
[-UnifiedGroupWelcomeMessageEnabled]
[-WhatIf]
[<CommonParameters>]
Description
Microsoft 365 群組是跨 Microsoft 365 服務提供的群組物件。
注意事項
您無法變更現有 Microsoft 365 群組上的 HiddenGroupMembershipEnabled 設定。 只有在新的群組建立期間,才能使用此設定。
您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet。
範例
範例 1
Set-UnifiedGroup -Identity "Marketing Department" -PrimarySmtpAddress marketing@contoso.com -RequireSenderAuthenticationEnabled $false
此範例會對名為 Marketing Department 的 Microsoft 365 群組進行下列變更:
- 主要電子郵件地址會變更為 marketing@contoso.com 。
- Microsoft 365 群組可從未經驗證的 (外部) 寄件者接收郵件。
範例 2
Set-UnifiedGroup -Identity "Legal Department" -AccessType Private
本範例會將名為法務部門的 Microsoft 365 群組從公用群組變更為私人群組。
參數
-AcceptMessagesOnlyFromSendersOrMembers
AcceptMessagesOnlyFromSendersOrMembers 參數會指定誰可以傳送郵件給這個收件者。 來自其他寄件者的訊息會遭到拒絕。
此參數的有效值為您組織中的個別寄件者和群組。 個別寄件者為信箱、郵件使用者和郵件連絡人。 群組為通訊群組、擁有郵件功能的安全性群組和動態通訊群組。 指定群組表示允許群組的所有成員傳送訊息給這個收件者。
若要指定此參數的寄件者,您可以使用可唯一識別寄件者的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 標準 DN
- GUID
您可以輸入多個以逗號分隔的寄件者。 若要覆寫任何現有的專案,請使用下列語法: Sender1,Sender2,...SenderN
。 如果值包含空格或需要引號,請使用下列語法: "Sender1","Sender2",..."SenderN"
。
根據預設,此參數為空白 ($null) ,可讓此收件者接受來自所有寄件者的郵件。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-AccessType
AccessType 參數會指定 Microsoft 365 群組的隱私權類型。 有效值為:
- 公開:群組內容和交談可供所有人使用,而且任何人都可以在未經群組擁有者核准的情況下加入群組。
- 私人:群組內容和交談僅供群組成員使用,而加入群組需要群組擁有者核准。
注意:雖然使用者必須是成員才能參與私人群組,但任何人都可以傳送電子郵件給私人群組,並接收來自私人群組的回復。
Type: | ModernGroupTypeInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Alias
Alias 參數會指定 Exchange 別名 (也稱為 Microsoft 365 群組的郵件昵稱) 。 此值會將收件者識別為啟用郵件的物件,且不應與相同收件者 (也稱為 proxy 位址) 的多個電子郵件地址混淆。 收件者只能有一個別名值。 最大長度為 64 個字元。
別名值可以包含字母、數位和下列字元:
- !、#、% *、+、-、/、=、?、^、_和 ~。
- $、 & 、'、'、{、}和 | 必須逸出 (例如
-Alias what`'snew
) 或以單引號括住的整個值 (例如,-Alias 'what'snew'
) 。 &Azure AD Connect 同步處理的別名值不支援字元。 - (.) 的句號必須以其他有效字元括住,
help.desk
例如) (。 - Unicode 字元 U+00A1 至 U+00FF。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-AlwaysSubscribeMembersToCalendarEvents
AlwaysSubscribeMembersToCalendarEvents 參數會控制新增至 Microsoft 365 群組之新成員的預設訂閱設定。 變更此設定不會影響現有的群組成員。
- 如果您使用此參數而沒有值,則新增至群組的所有未來成員都會將其訂用帳戶設定為 ReplyAndEvents。 先前的事件不會自動新增至其行事曆。
- 如果您使用這個確切語法:
-AlwaysSubscribeMembersToCalendarEvents:$false,
新增至群組的所有未來成員都會將其訂用帳戶設定為 ReplyOnly。
群組成員可以變更自己的訂用帳戶設定,以覆寫您預期使用的此參數。
AutoSubscribeNewMembers 參數會覆寫此參數。
注意:只有當您從組織新增內部成員時,才會評估此屬性。 當新增為成員時,一律會訂閱來賓使用者帳戶。 您可以使用 Remove-UnifiedGroupLinks Cmdlet 手動移除來賓使用者的訂用帳戶。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-AuditLogAgeLimit
AuditLogAgeLimit 參數會指定 Microsoft 365 群組稽核記錄專案的存留期上限。 移除早于指定值的記錄專案。 預設值為 90 天。
若要指定值,請輸入時間範圍值:dd.hh:mm:ss,其中 dd = 天數、hh = 時數、mm = 分鐘數,而 ss = 秒數。
例如,若要將此參數會指定為 60 天,請使用 60.00:00:00。
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-AutoSubscribeNewMembers
AutoSubscribeNewMembers 參數會指定是否要自動訂閱新增至 Microsoft 365 群組的新成員至交談和行事曆事件。 只有啟用此設定之後新增至群組的使用者會自動訂閱群組。
- 若要訂閱交談和行事曆事件的新成員,請使用 AutoSubscribeNewMembers 參數,而不需要值。
- 如果您不想訂閱交談和行事曆事件的新成員,請使用下列確切語法:
-AutoSubscribeNewMembers:$false
。
注意:只有當您從組織新增內部成員時,才會評估此屬性。 當新增為成員時,一律會訂閱來賓使用者帳戶。 您可以使用 Remove-UnifiedGroupLinks Cmdlet 手動移除來賓使用者的訂用帳戶。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CalendarMemberReadOnly
CalendarMemberReadOnly 參數會指定是否要將群組成員的唯讀行事曆許可權設定為 Microsoft 365 群組。
- 若要設定唯讀行事曆許可權,請使用 CalendarMemberReadOnly 參數而不使用值。
- 若要移除唯讀行事曆許可權,請使用下列確切語法:
-CalendarMemberReadOnly:$false
。
若要檢視 Microsoft 365 群組上 CalendarMemberReadOnly 屬性的目前值,請將 取代 <EmailAddress>
為群組的電子郵件地址,然後執行下列命令: Get-UnifiedGroup -Identity <EmailAddress> -IncludeAllProperties | Format-List *Calendar*
。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Classification
Classification 參數會指定 Microsoft 365 群組的分類。 您必須先在 Azure Active Directory 中設定可用分類清單,才能指定此參數的值。 如需詳細資訊,請參閱 用於設定群組設定的 Azure Active Directory Cmdlet。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false
。 - 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-ConnectorsEnabled
ConnectorsEnabled 會指定是否要啟用使用 Microsoft 365 群組連接器的能力。
- 若要啟用連接器,請使用不含值的 ConnectorsEnabled 參數。
- 若要停用連接器,請使用下列確切語法:
-ConnectorsEnabled:$false
。
若要使用此參數,Set-OrganizationConfig Cmdlet 上的 ConnectorsEnabled 參數值必須設定為 $true (這是預設值) 。
如需Microsoft 365 群組連接器的詳細資訊,請參閱在 Outlook 中將應用程式連線到您的群組。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute1
此參數會指定收件者上 CustomAttribute1 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute10
此參數會指定收件者上 CustomAttribute10 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute11
此參數會指定收件者上 CustomAttribute11 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute12
這個參數會指定收件者上 CustomAttribute12 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute13
此參數會指定收件者上 CustomAttribute13 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute14
此參數會指定收件者上 CustomAttribute14 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute15
此參數會指定收件者上 CustomAttribute15 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute2
此參數會指定收件者上 CustomAttribute2 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute3
這個參數會指定收件者上 CustomAttribute3 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute4
這個參數會指定收件者上 CustomAttribute4 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute5
此參數會指定收件者上 CustomAttribute5 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute6
此參數會指定收件者上 CustomAttribute6 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute7
此參數會指定收件者上 CustomAttribute7 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute8
這個參數會指定收件者上 CustomAttribute8 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-CustomAttribute9
此參數會指定收件者上 CustomAttribute9 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 最大長度為 1024 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-DataEncryptionPolicy
DataEncryptionPolicy 參數會指定套用至 Microsoft 365 群組的資料加密原則。 您可以使用唯一識別原則的任何值。 例如:
- 名稱
- 辨別名稱 (DN)
- GUID
若要移除現有的原則,請使用值$null。
Type: | DataEncryptionPolicyIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-DisplayName
DisplayName 參數會指定 Microsoft 365 群組的名稱。 顯示名稱會顯示在 Exchange 系統管理中心、通訊清單和 Outlook 中。 最大長度為 64 個字元。 如果值包含空格,請使用引號 (") 括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-EmailAddresses
EmailAddresses 參數會指定收件者 (Proxy 位址) 的所有電子郵件地址,包括主要 SMTP 位址。 在內部部署 Exchange 組織中,主要 SMTP 位址和其他 Proxy 位址通常是由電子郵件地址原則所設定。 不過,您可以使用此參數來設定收件者的其他 Proxy 位址。 如需詳細資訊,請參閱Email Exchange Server中的位址原則。
此參數的有效語法為 "Type:EmailAddress1","Type:EmailAddress2",..."Type:EmailAddressN"
。 選擇性的 'Type 值會指定電子郵件地址的類型。 有效值的範例包括:
- SMTP:主要 SMTP 位址。 您只能在命令中使用此值一次。
- SMTP:主要 SMTP 地址。在命令中,您只能使用這個值一次。
- X400:內部部署 Exchange 中的 X.400 位址。
- X500:內部部署 Exchange 中的 X.500 位址。
如果您未包含電子郵件地址的 Type 值,則會假設為 smtp 值。 請注意,Exchange 不會驗證自訂網址類別型的語法, (包括) 的 X.400 位址。 因此,您必須確認已正確格式化任何自訂位址。
如果您未包含電子郵件地址的
- 使用位址上的 Type 值 SMTP。
- 當您不使用任何 Type 值,或使用多個小寫 smtp Type 值時,第一個電子郵件地址。
- 請改用 PrimarySmtpAddress 參數。 您無法在同一個命令中使用 EmailAddresses 參數和 PrimarySmtpAddress 參數。
若要以您指定的值取代所有現有的 Proxy 電子郵件地址,請使用下列語法: "Type:EmailAddress1","Type:EmailAddress2",..."Type:EmailAddressN"
。
若要新增或移除指定 Proxy 位址而不影響其他現有值,請使用下列語法: @{Add="Type:EmailAddress1","Type:EmailAddress2",...; Remove="Type:EmailAddress3","Type:EmailAddress4",...}
。
Type: | ProxyAddressCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-ExtensionCustomAttribute1
這個參數會指定收件者上 ExtensionCustomAttribute1 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 您可以指定最多 1300 個以逗號分隔的值。
若要輸入覆寫任何現有專案的多個值,請使用下列語法: Value1,Value2,...ValueN
。 如果值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"
。
若要新增或移除一或多個值而不影響任何現有的專案,請使用下列語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-ExtensionCustomAttribute2
這個參數會指定收件者上 ExtensionCustomAttribute2 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 您可以指定最多 1300 個以逗號分隔的值。
若要輸入覆寫任何現有專案的多個值,請使用下列語法: Value1,Value2,...ValueN
。 如果值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"
。
若要新增或移除一或多個值而不影響任何現有的專案,請使用下列語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-ExtensionCustomAttribute3
這個參數會指定收件者上 ExtensionCustomAttribute3 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 您可以指定最多 1300 個以逗號分隔的值。
若要輸入覆寫任何現有專案的多個值,請使用下列語法: Value1,Value2,...ValueN
。 如果值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"
。
若要新增或移除一或多個值而不影響任何現有的專案,請使用下列語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-ExtensionCustomAttribute4
這個參數會指定收件者上 ExtensionCustomAttribute4 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 您可以指定最多 1300 個以逗號分隔的值。
若要輸入覆寫任何現有專案的多個值,請使用下列語法: Value1,Value2,...ValueN
。 如果值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"
。
若要新增或移除一或多個值而不影響任何現有的專案,請使用下列語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-ExtensionCustomAttribute5
這個參數會指定收件者上 ExtensionCustomAttribute5 屬性的值。 您可以使用此屬性來儲存收件者的自訂資訊,以及在篩選中識別收件者。 您可以指定最多 1300 個以逗號分隔的值。
若要輸入覆寫任何現有專案的多個值,請使用下列語法: Value1,Value2,...ValueN
。 如果值包含空格或需要引號,請使用下列語法: "Value","Value2",..."ValueN"
。
若要新增或移除一或多個值而不影響任何現有的專案,請使用下列語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-ForceUpgrade
如果物件是在舊版 Exchange 中建立,則 ForceUpgrade 參數會隱藏出現的確認訊息。 您不需要使用此參數指定值。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-GrantSendOnBehalfTo
GrantSendOnBehalfTo 參數會指定誰可以代表此 Microsoft 365 群組傳送。 雖然代表群組傳送的訊息會在 [寄件者] 欄位中清楚地顯示寄件者 (<Sender> on behalf of <Microsoft 365 Group>
) ,但這些訊息的回復會傳遞至群組,而不是寄件者。
您為此參數指定的寄件者必須是信箱、郵件使用者或擁有郵件功能的安全性群組 (可以擁有指派權限且擁有郵件功能的安全性主體)。 您可以使用唯一識別寄件者的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- Domain\Username
- 電子郵件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 使用者識別碼或使用者主要名稱 (UPN)
若要輸入多個值並覆寫任何現有的專案,請使用下列語法: Value1,Value2,...ValueN
。 如果值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"
。
若要新增或移除一或多個值而不影響任何現有的專案,請使用下列語法: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
。
根據預設,此參數是空白的,這表示沒有其他人有權代表此 Microsoft 365 群組傳送。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-HiddenFromAddressListsEnabled
HiddenFromAddressListsEnabled 參數會指定 Microsoft 365 群組是否出現在全域通訊清單中, (GAL) 和組織中的其他通訊清單。 有效值為:
- $true:MICROSOFT 365 群組會從 GAL 和其他通訊清單中隱藏。 群組仍然可以接收訊息,但使用者無法搜尋或流覽至 Outlook 或 Outlook 網頁版 中的群組。 使用者也無法在Outlook 網頁版中使用 [探索] 選項來尋找群組。 對於屬於 Microsoft 365 群組成員的使用者,群組仍會出現在 Outlook 的流覽窗格中,如果未啟用 HiddenFromExchangeClientsEnabled 屬性,則會Outlook 網頁版。
- $false:MICROSOFT 365 群組會顯示在 GAL 和其他通訊清單中。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-HiddenFromExchangeClientsEnabled
HiddenFromExchangeClientsEnabled 參數會指定是否對連線至 Microsoft 365 的 Outlook 用戶端隱藏 Microsoft 365 群組。
- 若要啟用此設定,您不需要使用此參數指定值。 Microsoft 365 群組會隱藏在 Outlook 體驗中。 群組不會顯示在 Outlook 左側導覽中,且不會顯示在 GAL) (全域通訊清單中。 在 Outlook 中建立新訊息期間,不會解析組名。 群組仍然可以接收訊息,但使用者無法搜尋或流覽至 Outlook 或 Outlook 網頁版 中的群組。 使用者也無法在Outlook 網頁版中使用 [探索] 選項來尋找群組。 此外,HiddenFromAddressListsEnabled 屬性也會設定為 true,以防止群組顯示在 GAL 和離線通訊錄 (OAB) 中。
- 若要停用此設定,請使用下列確切語法:
-HiddenFromExchangeClientsEnabled:$false
。 Microsoft 365 群組不會隱藏在 Outlook 體驗中。 此群組會顯示在 GAL 和其他通訊清單中。 這是預設值。 - 如果 exchange 用戶端隱藏Microsoft 365 群組,使用者就無法檢視訂閱或取消訂閱 Microsoft 365 群組的選項。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Identity
Identity 參數會指定您要修改的 Microsoft 365 群組。 您可以使用可唯一識別 Microsoft 365 群組的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 標準 DN
- GUID
Type: | UnifiedGroupIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-InformationBarrierMode
InformationBarrierMode 參數會指定 Microsoft 365 群組的資訊屏障模式。 有效值為:
- Explicit
- 隱 式
- 開啟
- OwnerModerated
Type: | GroupInformationBarrierMode |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-IsMemberAllowedToEditContent
{{ Fill IsMemberAllowedToEditContent Description }}
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Language
Language 參數會指定 Microsoft 365 群組的語言喜好設定。
此參數的有效輸入是來自 Microsoft .NET Framework CultureInfo 類別的支援文化特性程式碼值。 例如,丹麥文為 da-DK 或日文為 ja-JP。 如需詳細資訊,請參閱 CultureInfo 類別。
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-MailboxRegion
MailboxRegion 參數會指定多地理位置環境中 Microsoft 365 群組的慣用資料位置 (PDL) 。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-MailTip
MailTip 參數會指定此收件者的自訂 MailTip 文字。 當寄件者開始草擬電子郵件訊息給這個收件者時,會向寄件者顯示郵件提示。 如果值包含空格,請使用引號 (") 括住值。
MailTip 參數會指定此收件者的自訂郵件提示文字。當寄件者開始草擬給此收件者的電子郵件時,系統會向寄件者顯示郵件提示。如果值包含空格,請使用引號 (") 括住值。
- 自動在文字中加入 HTML 標記。 例如,如果您輸入下列文字:「此信箱未受監視」,則 MailTip 會自動變成:
<html><body>This mailbox is not monitored</body></html>
。 不支援其他 HTML 標籤,且 MailTip 的長度不能超過 175 個顯示的字元。 - 文字會自動新增至收件者的 MailTipTranslations 屬性做為預設值:
default:<MailTip text>
。 如果您修改 MailTip 文字,預設值會在 MailTipTranslations 屬性中自動更新,反之亦然。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-MailTipTranslations
MailTipTranslations 參數會為 MailTip 參數所定義的自訂 MailTip 文字指定其他語言。 HTML 標籤會自動新增至 MailTip 翻譯、不支援其他 HTML 標籤,而且 MailTip 翻譯的長度不能超過 175 個顯示的字元。
MailTipTranslations 參數能指定 MailTip 參數定義之自訂郵件提示文字的其他語言。系統會將 HTML 標籤自動加入郵件提示轉譯,其他 HTML 標籤不受支援,且郵件提示轉譯的長度不可超過 175 個顯示字元。
@{Add="Culture1:Localized text 1","\Culture2:Localized text 2"...; Remove="Culture3:Localized text 3","Culture4:Localized text 4"...}
.
CultureN 是有效的 ISO 639 兩個字母文化特性程式碼,與語言相關聯。
例如,假設此收件者目前具有 MailTip 文字:「此信箱未受到監視」。若要新增西班牙文翻譯,請針對此參數使用下列值: @{Add="ES:Esta caja no se supervisa."}
。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-MaxReceiveSize
MaxReceiveSize 參數會指定可傳送至此群組的電子郵件訊息大小上限。 群組會拒絕超過大小上限的訊息。
有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。
- B (位元組)
- KB (千位元組)
- MB (百萬位元組)
- GB (十億位元組)
TB (TB)
有效值是最高 1.999999 GB (2147483647 個位元組) 的數值或 unlimited 值。 預設值是無限制的,這表示大小上限會加在其他位置 (例如,組織、伺服器或連接器限制) 。
Base64 編碼會增加大約 33% 的訊息大小,因此請指定比您想要強制執行的實際訊息大小上限大 33% 的值。 例如,值 64 MB 會導致訊息大小上限約為 48 MB。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-MaxSendSize
MaxSendSize 參數會指定此群組可以傳送的電子郵件訊息大小上限。
有效值是最高 1.999999999 TB (2199023254528 個位元組) 的數值或 unlimited 值。預設值是 6 GB (6442450944 個位元組)。
- B (位元組)
- KB (千位元組)
- MB (百萬位元組)
- GB (十億位元組)
TB (TB)
有效值是最高 1.999999 GB (2147483647 個位元組) 的數值或 unlimited 值。 預設值是無限制的,這表示大小上限會加在其他位置 (例如,組織、伺服器或連接器限制) 。
Base64 編碼會增加大約 33% 的訊息大小,因此請指定比您想要強制執行的實際訊息大小上限大 33% 的值。 例如,值 64 MB 會導致訊息大小上限約為 48 MB。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-ModeratedBy
ModeratedBy 參數會指定此收件者的一或多位仲裁者。 傳送給此收件者的郵件必須先經過仲裁者核准才能傳遞。 仲裁者必須是組織中的信箱、郵件使用者或郵件連絡人。 您可以使用唯一識別仲裁者的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 標準 DN
- GUID
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號,請使用下列語法: "Value1","Value2",..."ValueN"
。
當您將 ModerationEnabled 參數設定為值 $true 時,您需要使用此參數來指定至少一個仲裁者。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange, Exchange Online Protection |
-ModerationEnabled
ModerationEnabled 參數會指定是否為此收件者啟用仲裁。 有效值為:
- $true:已為此收件者啟用仲裁。 傳送給此收件者的郵件必須先由仲裁者核准,才能傳遞訊息。
- $false:已停用此收件者的仲裁。 傳送給此收件者的訊息會在未經仲裁者核准的情況下傳遞。 這是預設值。
您可以使用 ModeratedBy 參數來指定仲裁者。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-Notes
Notes 參數會指定 Microsoft 365 群組的描述。 如果值包含空格,請使用引號括住值。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange, Exchange Online Protection |
-PrimarySmtpAddress
PrimarySmtpAddress 參數會指定用於收件者的主要回覆電子郵件地址。 您無法在相同的命令中使用 EmailAddresses 和 PrimarySmtpAddress 參數。
Type: | SmtpAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-RejectMessagesFromSendersOrMembers
RejectMessagesFromSendersOrMembers 參數會指定不允許誰傳送郵件給這個收件者。 來自這些寄件者的訊息會遭到拒絕。
此參數的有效值為您組織中的個別寄件者和群組。 個別寄件者為信箱、郵件使用者和郵件連絡人。 群組為通訊群組、擁有郵件功能的安全性群組和動態通訊群組。 指定群組表示不允許群組的所有成員傳送郵件給這個收件者。
若要指定此參數的寄件者,您可以使用可唯一識別寄件者的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- 標準 DN
- GUID
您可以輸入多個以逗號分隔的寄件者。 若要覆寫任何現有的專案,請使用下列語法: Sender1,Sender2,...SenderN
。 如果值包含空格或需要引號,請使用下列語法: "Sender1","Sender2",..."SenderN"
。
若要在不影響其他現有專案的情況下新增或移除個別寄件者或群組,請使用 RejectMessagesFrom 和 RejectMessagesFromDLMembers 參數。
您為此參數指定的個別寄件者和群組會分別自動複製到 RejectMessagesFrom 和 RejectMessagesFromDLMembers 屬性。 因此,您無法在同一個命令中使用 RejectMessagesFromSendersOrMembers 參數和 RejectMessagesFrom 或 RejectMessagesFromDLMembers 參數。
根據預設,此參數為空白 ($null) ,可讓此收件者接受來自所有寄件者的郵件。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-RequireSenderAuthenticationEnabled
RequireSenderAuthenticationEnabled 參數會指定是否只接受來自已驗證 (內部) 寄件者的訊息。 有效值為:
- $true:只有經過驗證的 (內部) 寄件者才能接受訊息。 來自未經驗證 (外部) 寄件者的訊息會遭到拒絕。
- $true:只接受來自驗證過 (內部) 寄件者的郵件。來自未經驗證 (外部) 寄件者的郵件會遭到拒絕。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-SensitivityLabelId
SensitivityLabelId 參數會指定指派給 Microsoft 365 群組之敏感度標籤的 GUID 值。
注意:在 Get-UnifiedGroup Cmdlet 的輸出中,此屬性的名稱為 SensitivityLabel,而非 SensitivityLabelId。
Type: | System.Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-SubscriptionEnabled
SubscriptionEnabled 參數會指定群組擁有者是否可以在他們擁有的群組上啟用交談和行事曆事件的訂閱。 此選項只能在 Exchange Online PowerShell 中設定。
- 若要將值變更為 $true,請使用此參數而不含值。
- 若要將值變更為 $false,請使用下列確切語法:
-SubscriptionEnabled:$false
。 您必須先$false AutoSubscribeNewMembers 參數的值,才能使用此參數的值$false。
注意:只有在您想要停用群組擁有者變更群組上訂用帳戶選項的能力時,才應該使用此參數的值$false。 群組擁有者將無法使用 Outlook 網頁版 或 Outlook 桌面,在群組設定上啟用訂用帳戶選項。 當群組擁有者嘗試啟用 [訂用帳戶] 選項時,可能會看到錯誤「群組更新正在進行中」錯誤。 嘗試從 Microsoft 系統管理中心啟用訂用帳戶的系統管理員也可能會看到錯誤:「無法儲存「將群組交談和事件的複本傳送至群組成員的收件匣」:指派的產品授權不包含Exchange Online或您最近已建立此群組,但該群組尚未準備好進行管理」。
注意:只有當您從組織新增內部成員時,才會評估此屬性。 當新增為成員時,一律會訂閱來賓使用者帳戶。 您可以使用 Remove-UnifiedGroupLinks Cmdlet 手動移除來賓使用者的訂用帳戶。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-UnifiedGroupWelcomeMessageEnabled
UnifiedGroupWelcomeMessageEnabled 參數會指定是否要啟用或停用傳送系統產生的歡迎訊息給新增為 Microsoft 365 群組成員的使用者。
- 若要啟用此設定,您不需要使用此參數指定值。
- 若要停用此設定,請使用下列確切語法:
-UnifiedGroupWelcomeMessageEnabled:$false
。
此設定只會控制 Microsoft 365 群組所傳送的電子郵件。 它不會控制連線產品 (例如 Teams 或 Yammer) 所傳送的電子郵件。
預設會啟用此設定。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-WhatIf
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |