New-SPSecureStoreServiceApplicationProxy

發行項
04/20/2016

適用版本： SharePoint Server 2010

上次修改主題的時間： 2015-03-09

會在伺服器陣列中建立新的安全認證儲存服務應用程式 Proxy。

Syntax

New-SPSecureStoreServiceApplicationProxy -Uri <Uri> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DefaultProxyGroup <SwitchParameter>] [-Name <String>] [-WhatIf [<SwitchParameter>]]

New-SPSecureStoreServiceApplicationProxy -ServiceApplication <SPServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-DefaultProxyGroup <SwitchParameter>] [-Name <String>] [-WhatIf [<SwitchParameter>]]

詳細描述

此 Cmdlet 包含一個以上的參數集。您可能只使用一個參數集中的參數，但不可以結合不同參數集的參數。如需如何使用參數集的詳細資訊，請參閱 Cmdlet Parameter Sets。

New-SPSecureStoreServiceApplicationProxy Cmdlet 會在伺服器陣列中，針對安全認證儲存服務應用程式建立新的安全認證儲存服務應用程式 Proxy。

New-SPSecureStoreServiceApplicationProxy Cmdlet 不會指定服務應用程式 Proxy 是否為已分割。如果想指定分割的服務應用程式 Proxy，可以使用 New-SPSecureStoreServiceApplication Cmdlet 來建立分割的服務應用程式。New-SPSecureStoreServiceApplication Cmdlet 的結果可以傳遞至 New-SPSecureStoreServiceApplicationProxy Cmdlet。同理，如果想指定不分割的服務應用程式 Proxy，可以使用 New-SPSecureStoreServiceApplication Cmdlet，來建立不分割的服務應用程式。New-SPSecureStoreServiceApplication Cmdlet 的結果可以傳遞至 New-SPSecureStoreServiceApplicationProxy Cmdlet。

Parameters

參數	必要	類型	描述
ServiceApplication	必要	Microsoft.SharePoint.PowerShell.SPServiceApplicationPipeBind	指定與新 Proxy 相關聯的本機安全認證儲存服務應用程式。
Uri	必要	System.Uri	指定與新 Proxy 相關聯之遠端安全認證儲存服務應用程式的 URI。此類型必須是格式為 file:\\server_name\sitedocs 的有效 URI。
AssignmentCollection	選用	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	為能適當處置物件而管理物件。使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體，因此在 Windows PowerShell 指令碼中使用這些物件時，必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。使用 SPWeb、SPSite 或 SPSiteAdministration 物件時，若未使用指派集合或 Global 參數，將會自動處置這些物件。注意使用 Global 參數時，所有物件會包含在全域儲存區內。若未立即使用物件，或未使用 Stop-SPAssignment 命令處置物件，將會發生記憶體不足的狀況。
Confirm	選用	System.Management.Automation.SwitchParameter	執行命令之前，會先提示您進行確認。如需詳細資訊，請輸入下列命令：get-help about_commonparameters
DefaultProxyGroup	選用	System.Management.Automation.SwitchParameter	指定要將服務應用程式 Proxy 新增至伺服器陣列的預設 Proxy 群組。
Name	選用	System.String	指定要建立之新服務應用程式 Proxy 的名稱。
WhatIf	選用	System.Management.Automation.SwitchParameter	顯示訊息描述命令效果，而非描述命令執行的效果。如需詳細資訊，請輸入下列命令：get-help about_commonparameters

輸入類型

傳回類型

錯誤

錯誤	描述

Exceptions

例外狀況	描述

Example

------------------範例 1------------------

New-SPSecureStoreServiceApplicationProxy -Name "Contoso Service Application Proxy" -ServiceApplication $SSServiceApp

此範例會為指定的服務應用程式建立名稱為 Contoso Service Application Proxy 的新安全認證儲存服務應用程式 Proxy。

------------------範例 2------------------

$nameofproxy = "Connection to: HostedSecureStoreInParentFarm"

$proxy = Get-SPServiceApplicationProxy | where {$_ -match $nameofproxy}

$prop = $proxy.Properties

$type = $prop["Microsoft.Office.Server.Utilities.SPPartitionOptions"].GetType()

$partition = [enum]::Parse( $type, 1 )

$prop["Microsoft.Office.Server.Utilities.SPPartitionOptions"] = $partition

$proxy.Update()

此範例會將子項中未分割的安全認證儲存服務應用程式 Proxy 轉換成已分割。