DeleteParty (BizTalk Server 範例)

發行項
10/14/2023

DeleteParty 範例示範如何刪除指定的合作對象。

警告

如果在部署後不需要部署指令碼，就應該將其移除。必須保留的系統管理指令碼和其他指令碼都應該由 ACL 保護，而且予以密切監控。

注意

您必須先建立合作對象，才可以將它刪除。其中一種方法是執行PartyResolution (BizTalk Server 範例) 範例。

必要條件

您必須擁有BizTalk Server系統管理許可權，才能使用此範例中的系統管理物件。
Windows PowerShell腳本需要Windows PowerShell執行原則，才能允許腳本執行。如需詳細資訊，請參閱 about_Execution_Policies。

此範例的用途

此範例是以 Microsoft Visual C# 撰寫，使用 BizTalk Explorer 物件模型 (ExplorerOM) 的物件，執行下列作業：

查詢指定的合作對象。
刪除該合作對象。
處理任何錯誤，讓有意義的資訊能傳回給使用者。

可在何處找到此範例

這個範例位於下列 SDK 位置：

<範例路徑>\管理員\ExplorerOM\DeleteParty\

下表顯示此範例中的檔案，並描述其用途。

檔案	Description
App.ico、AssemblyInfo.cs、DeleteParty.csproj、DeleteParty.sln、DeleteParty.cs	專案、方案和原始程式檔，用於建置 Visual C# 命令列應用程式，以移除指定的合作對象。

若要建置並初始化這個範例

在 Visual Studio 中，開啟方案檔 DeleteParty.sln。
在 [建置] 功能表上，按一下 [建置方案]。

執行此範例

在命令視窗中，瀏覽至下列資料夾：

<範例路徑>\管理員\ExplorerOM\DeleteParty\bin\Debug\
執行 DeleteParty.exe 檔案，它會傳遞下列兩個命令列引數：
- <PartyName> 。要刪除之合作物件的名稱。如果合作對象名稱包含空格，請用引號括住該名稱。
- /?. 顯示說明。
  
  例如：
```
DeleteParty "My Party #3"
```
-或-
```
DeleteParty /?
```

Windows Powershell 腳本範例

下列Windows PowerShell腳本片段可用來示範ExplorerOM類別的相同功能：


#===================#
#=== Main Script ===#
#===================#

#=== Make sure the ExplorerOM assembly is loaded ===#

[void] [System.reflection.Assembly]::LoadWithPartialName("Microsoft.BizTalk.ExplorerOM")

#=== Connect to the BizTalk Management database ===#

$Catalog = New-Object Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer
$Catalog.ConnectionString = "SERVER=.;DATABASE=BizTalkMgmtDb;Integrated Security=SSPI"

#=======================================#
#=== If no party name is specified   ===#
#=== just list the parties.          ===#
#=======================================#

if ($args[0] -eq $null)
{
  Write-Host `r`nNo party name provided for delete operation.`r`n`r`nListing Parties on local Biztalk Server:

  $Catalog.Parties | Format-List Name
}

#==========================================#
#=== Delete the specified party by name ===#
#==========================================#

else
{
  $party = $Catalog.Parties[$args[0]]
  Write-Host `r`nRemoving Party named `"($args[0])`"`r`n
  $catalog.RemoveParty($party)
  $catalog.SaveChanges()
}

腳本範例預期會以命令列引數的形式傳遞單一合作物件名稱。它會依名稱尋找該合作物件，並嘗試將其刪除。如果本機 Biztalk 伺服器上沒有傳遞任何命令列引數，腳本將會列出所有合作物件。以下是腳本的範例輸出：

PS C:\> .\DeletePart.ps1

No party name provided for delete operation.

Listing Parties on local Biztalk Server:

Name : Party1

Name : Party3

Name : Party2

PS C:\> .\DeletePart.ps1 Party3

Removing Party named " Party3 "

PS C:\> .\DeletePart.ps1

No party name provided for delete operation.

Listing Parties on local Biztalk Server:

Name : Party1

Name : Party2

另請參閱

Admin-ExplorerOM (BizTalk Server Samples 資料夾)

共用方式為