New-PowerShellVirtualDirectory

模組:
Exchange PowerShell

內部部署 Exchange 才有提供此 Cmdlet。

使用 New-PowerShellVirtualDirectory Cmdlet 建立Windows PowerShell虛擬目錄，供 Microsoft Exchange 伺服器上的 Internet Information Services (IIS) 使用。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

語法

Default (預設值) 

New-PowerShellVirtualDirectory
    [-Name] <String>
    [-BasicAuthentication <Boolean>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ExtendedProtectionFlags <MultiValuedProperty>]
    [-ExtendedProtectionSPNList <MultiValuedProperty>]
    [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
    [-ExternalUrl <Uri>]
    [-InternalUrl <Uri>]
    [-RequireSSL <Boolean>]
    [-Role <VirtualDirectoryRole>]
    [-Server <ServerIdParameter>]
    [-WhatIf]
    [-WindowsAuthentication <Boolean>]
    [<CommonParameters>]

Description

雖然您可以建立 Windows PowerShell 虛擬目錄，但建議您只在 Microsoft 客戶服務與支援人員的要求時這麼做。

您必須已獲指派權限，才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數，但如果指派給您的權限中未包含某些參數，您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

New-PowerShellVirtualDirectory -Name "Contoso Certificates Required" -BasicAuthentication $false -WindowsAuthentication $false -CertificateAuthentication $true

此範例會建立 Windows PowerShell 虛擬目錄，並將其設定為只接受憑證驗證。

參數

-BasicAuthentication

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

BasicAuthentication 參數會指定是否在 PowerShell 虛擬目錄上啟用基本驗證。 有效值為 $true 及 $false。 預設值為 $true。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:CF

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DomainController

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

參數屬性

類型:Fqdn
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ExtendedProtectionFlags

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ExtendedProtectionFlags 參數會指定虛擬目錄上驗證擴充保護的自訂設定。 有效值為：

  • 無：這是預設的設定。
  • AllowDotlessSPN：如果要使用服務主體名稱 (SPN) 不包含 FQDN 的值，則為必要 (例如 HTTP/ContosoMail 而不是 HTTP/mail.contoso.com) 。 您可以使用 ExtendedProtectionSPNList 參數指定 SPN。 此設定會降低驗證的延伸保護安全性，因為無點憑證並不是唯一的，因此無法確保透過安全通道建立用戶端對 Proxy 的連線。
  • NoServiceNameCheck：不會檢查 SPN 清單以驗證通道繫結權杖。 此設定會降低驗證的延伸保護安全性。 通常不建議使用此設定。
  • Proxy：Proxy 伺服器負責終止 TLS 通道。 若要使用此設定，您必須使用 ExtendedProtectionSPNList 參數來註冊 SPN。
  • ProxyCoHosting：HTTP 和 HTTPS 流量可能正在存取虛擬目錄，而且 Proxy 伺服器至少位於部分用戶端和 Exchange 伺服器上的用戶端存取服務之間。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ExtendedProtectionSPNList

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ExtendedProtectionSPNList 參數會指定有效的服務主體名稱清單 (SPN，) 如果您正在虛擬目錄上使用延伸保護進行驗證。 有效值為：

  • $null：此值為預設值。
  • 有效 SPN 的單一 SPN 或逗號分隔清單： SPN 值格式為 Protocol\FQDN。 例如，HTTP/mail.contoso.com。 若要新增非 FQDN (的 SPN，例如 HTTP/ContosoMail) ，您也需要針對 ExtendedProtectionFlags 參數使用 AllowDotlessSPN 值。

參數屬性

類型:MultiValuedProperty
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ExtendedProtectionTokenChecking

適用項目：Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ExtendedProtectionTokenChecking 參數會指定是否將驗證擴充保護用於用戶端連線至虛擬目錄。 有效值為：

  • 無：驗證擴充保護不用於用戶端連線至虛擬目錄。 此值為預設值。
  • 允許：如果用戶端和伺服器都支援驗證擴充保護，則驗證擴充保護用於用戶端連線至虛擬目錄。
  • 需要：用戶端連線至虛擬目錄時，需要驗證擴充保護。 如果用戶端或伺服器不支援，連線就會失敗。 這個值也需要 ExtendedProtectionSPNList 參數的服務主體名稱 (SPN) 值。

注意：如果 Exchange 伺服器前面的 Proxy 伺服器終止用戶端對 Proxy 傳輸層安全性 (TLS) 通道，則 ExtendedProtectionSPNList 參數的 [允許] 或 [要求] 值需要一個或多個 SPN 值。

參數屬性

類型:ExtendedProtectionTokenCheckingMode
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ExternalUrl

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

ExternalURL 參數會指定從防火牆外部連線至虛擬目錄的 URL。

參數屬性

類型:Uri
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-InternalUrl

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

InternalURL 參數會指定從防火牆內部連線至虛擬目錄的 URL。

參數屬性

類型:Uri
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Name 參數會指定新 PowerShell 虛擬目錄的名稱。 您提供的名稱會附加建立網站的名稱。 如果您所提供的名稱包含空格，請使用引號 (") 括住名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RequireSSL

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

RequireSSL 參數會指定連線至虛擬目錄的用戶端連線是否需要傳輸層安全性 (TLS) 加密。 有效值為：

  • $true：需要 TLS 加密才能連線到虛擬目錄。 此值為預設值。
  • $false：連線到虛擬目錄不需要 TLS 加密。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Role

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Role 參數可指定虛擬目錄的設定。 有效值為：

  • ClientAccess：在信箱伺服器上設定用戶端存取 (前端) 服務的虛擬目錄。
  • 信箱：在信箱伺服器上設定後端服務的虛擬目錄。

用戶端連線會從用戶端存取服務 proxy 至本機或遠端信箱伺服器上的後端服務。 Clients don't connect directly to the backend services.

參數屬性

類型:VirtualDirectoryRole
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Server

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Server 參數指定裝載虛擬目錄的 Exchange 伺服器。 您可以使用唯一識別伺服器的任何值。 例如：

  • Name
  • FQDN
  • 辨別名稱 (DN)
  • ExchangeLegacyDN

參數屬性

類型:ServerIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-WhatIf

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

WhatIf 參數會顯示命令在不進行任何變更的情況下執行的動作。 您不需要使用此參數指定值。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:WI

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WindowsAuthentication

適用項目：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

WindowsAuthentication 參數會指定是否在 PowerShell 虛擬目錄上啟用整合式 Windows 驗證。 有效值為 $true 及 $false。 預設值為 $true。

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。