New-ClientAccessRule

Action 參數指定用戶端存取規則的動作。 此參數的有效值為 AllowAccess 和 DenyAccess。

此參數只能在雲端式服務中運作。

AnyOfAuthenticationTypes 參數指定以用戶端驗證類型為基礎的用戶端存取規則條件。

此參數的有效值為：

• AdfsAuthentication
• BasicAuthentication
• CertificateBasedAuthentication
• NonBasicAuthentication
• OAuthAuthentication

您可以輸入多個以逗號分隔的值。 請勿使用引號。

注意：請參閱描述一節，以查看哪些驗證類型可以搭配哪些通訊協定使用。

AnyOfClientIPAddressesOrRanges 參數指定以用戶端 IPv4 或 IPv6 位址為基礎的用戶端存取規則條件。 有效值為：

• 單一 IP 位址：例如，192.168.1.1 或 2001:DB8::2AA:FF:C0A8:640A。
• IP 位址範圍：例如，192.168.0.1-192.168.0.254 或 2001:DB8::2AA:FF:C0A8:640A-2001:DB8::2AA:FF:C0A8:6414。
• 無類別網域間路由 (CIDR) IP 位址範圍：例如，192.168.3.1/24 或 2001:DB8::2AA:FF:C0A8:640A/64。

您可以輸入多個以逗號分隔的值。

有關 IPv6 位址和語法的詳細資訊，請參閱此 Exchange 2013 主題：IPv6 位址基礎。

AnyOfProtocols 參數指定以用戶端通訊協定為基礎的用戶端存取規則條件。

此參數的有效值為：

• ExchangeActiveSync
• ExchangeAdminCenter
• ExchangeWebServices
• IMAP4
• OfflineAddressBook
• OutlookAnywhere
• OutlookWebApp
• POP3
• PowerShellWebServices
• RemotePowerShell
• REST
• UniversalOutlook (郵件和行事曆應用程式)

備註：在 Exchange 2019 中，唯一支援的值是 ExchangeAdminCenter 和 RemotePowerShell。

您可以輸入多個以逗號分隔的值。 請勿使用引號。

將保留此參數供 Microsoft 內部使用。

Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。

• 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：-Confirm:$false。
• 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。

此 Cmdlet 具有內建暫停，因此請使用 -Confirm:$false 略過確認。

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。

Enabled 參數會指定啟用或停用用戶端存取規則。 這個參數的有效值是 $true 或 $false。 預設值為 $true。

此參數只能在雲端式服務中運作。

ExceptAnyOfAuthenticationTypes 參數指定以用戶端驗證類型為基礎的用戶端存取規則的例外狀況。

此參數的有效值為：

• AdfsAuthentication
• BasicAuthentication
• CertificateBasedAuthentication
• NonBasicAuthentication
• OAuthAuthentication

您可以輸入多個以逗號分隔的值。 請勿使用引號。

注意：請參閱描述一節，以查看哪些驗證類型可以搭配哪些通訊協定使用。

ExceptAnyOfClientIPAddressesOrRanges 參數指定以用戶端 IPv4 或 IPv6 位址為基礎的用戶端存取規則的例外狀況。 有效值為：

• 單一 IP 位址：例如，192.168.1.1 或 2001:DB8::2AA:FF:C0A8:640A。
• IP 位址範圍：例如，192.168.0.1-192.168.0.254 或 2001:DB8::2AA:FF:C0A8:640A-2001:DB8::2AA:FF:C0A8:6414。
• 無類別網域間路由 (CIDR) IP 位址範圍：例如，192.168.3.1/24 或 2001:DB8::2AA:FF:C0A8:640A/64。

您可以輸入多個以逗號分隔的值。

有關 IPv6 位址和語法的詳細資訊，請參閱此 Exchange 2013 主題：IPv6 位址基礎。

此參數只能在雲端式服務中運作。

ExceptAnyOfProtocols 參數指定以用戶端通訊協定為基礎的用戶端存取規則的例外狀況。

此參數的有效值為：

• ExchangeActiveSync
• ExchangeAdminCenter
• ExchangeWebServices
• IMAP4
• OfflineAddressBook
• OutlookAnywhere
• OutlookWebApp
• POP3
• PowerShellWebServices
• RemotePowerShell
• REST
• UniversalOutlook (郵件和行事曆應用程式)

您可以輸入多個以逗號分隔的值。 請勿使用引號。

將保留此參數供 Microsoft 內部使用。

將保留此參數供 Microsoft 內部使用。

此參數只能在雲端式服務中運作。

ExceptUsernameMatchesAnyOfPatterns 參數指定以格式 <Domain>\<UserName> 的使用者帳戶名稱 (例如，contoso.com\jeff) 為基礎的用戶端存取規則例外狀況。 此參數接受文字和通配符 (*) (例如 ， *jeff*但不 jeff*) 。 非英數字元不需要逸出字元。

您可以輸入多個以逗號分隔的值。

Name 參數指定用戶端存取規則的唯一名稱。

Priority 參數能為決定標籤處理順序的敏感度標籤指定優先順序值。 越低的整數值代表優先順序越高，0 值是最高優先順序，規則不能擁有相同的優先順序值。

Priority 參數能為決定規則處理順序的規則指定優先順序值。 越低的整數值代表優先順序越高，0 值是最高優先順序，規則不能擁有相同的優先順序值。

• 這個參數的有效值和預設值取決於現有規則的數目。例如，如果有 8 個現有規則：
• 這 8 個現有規則的有效優先順序值為 0 到 7。
• 新規則 (第九個規則) 的有效優先順序值為 0 到 8。

如果修改規則的優先順序值，規則在清單中的位置會變更，以符合您指定的優先順序值。 換句話說，如果您將某規則的優先順序值設定為與現有規則相同的值，對於現有規則和後續優先順序較低的其他所有規則，其優先順序值會增加 1。

Scope 參數會指定用戶端存取規則的範圍。 有效值為：

• Users：此規則僅適用於使用者連線。
• All：此規則會套用到所有連線 (使用者和中介層應用程式)。

將保留此參數供 Microsoft 內部使用。

此參數只能在雲端式服務中運作。

UsernameMatchesAnyOfPatterns 參數指定以格式 <Domain>\<UserName> 的使用者帳戶名稱 (例如，contoso.com\jeff) 為基礎的用戶端存取規則條件。 此參數接受文字和通配符 (*) (例如 ， *jeff*但不 jeff*) 。 非英數字元不需要逸出字元。 此參數無法與 -AnyOfProtocols UniversalOutlook 參數一起使用。

您可以輸入多個以逗號分隔的值。

此參數只能在雲端式服務中運作。

UserRecipientFilter 參數會指定用戶端存取規則的條件，該規則會使用 OPATH 篩選語法，根據一組有限的收件者屬性來識別使用者。 用戶端存取規則不支援可用收件者屬性的完整清單。

您可以使用下列屬性搭配此參數：

• 鄉/鎮/市/區
• Company
• CountryOrRegion (ISO 3166-1 alpha-2 country code.)
• CustomAttribute1 到 CustomAttribute15
• 部門
• 辦公室
• PostalCode
• StateOrProvince
• StreetAddress

此參數的基本語法為 "Property -ComparisonOperator 'Value'"：

• 屬性是上述清單中其中一個可篩選的屬性 (例如 City 或 CustomAttribute1) 。
• ComparisonOperator 是 OPATH 比較運算符 (例如 -eq equals 和 -like 字串比較) 。 如需比較運算子的詳細資訊，請參閱 about_Comparison_Operators。
• Value 是要搜尋的屬性值。 以單引號括住文字值和變數 ('Value' 或 '$Variable')。 如果變數值包含單引號，您必須識別 (逸出) 單引號，以正確展開變數。 例如，使用 '$($User -Replace "'","''")'，而不是 '$User'。 請勿以引弧括住整數或系統值 (例如，請改用 500、 $true、 $false或 $null) 。
• 以雙引號 「括住整個 OPATH 篩選條件」。 如果篩選條件包含系統值 (例如 $true、 $false 或 $null)，請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。

例如：

• "City -eq 'Redmond'"
• "CountryOrRegion -eq 'SG'".

您可以使用邏輯運算子 -and 和 -or 將多個搜尋準則鏈結在一起。 例如：

• "CustomAttribute1 -eq 'AllowOWA' -and CountryOrRegion -eq AU'"
• "(CountryOrRegion -eq 'US' -and Department -eq 'Sales') -or Department -eq 'Research'".

如需 Exchange 中 OPATH 篩選語法的詳細資訊，請參閱 其他 OPATH 語法資訊。

WhatIf 參數會模擬命令的動作。 使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。