DeleteParty (BizTalk Server サンプル)

[アーティクル]
05/04/2023

DeleteParty サンプルは、指定したパーティを削除する方法を示します。

警告

展開スクリプトは、展開後に不要になった場合は、削除する必要があります。保持する必要のある管理スクリプトおよび他のスクリプトは、ACL によってセキュリティで保護し、厳重に監視する必要があります。

Note

パーティを削除する前に、パーティを作成する必要があります。これを行う方法の 1 つは、PartyResolution (BizTalk Server サンプル) サンプルを実行する方法です。

前提条件

このサンプルの管理オブジェクトを使用するには、BizTalk Server管理特権が必要です。
Windows PowerShell スクリプトを実行するには、Windows PowerShell 実行ポリシーが必要です。詳細については、「about_Execution_Policies」を参照してください。

このサンプルの処理

このサンプルは、BizTalk エクスプローラーオブジェクトモデル (ExplorerOM) のオブジェクトを使用して Microsoft Visual C# で記述されており、以下の操作を実行します。

指定したパーティをクエリします。
そのパーティを削除します。
意味のある情報がユーザーに返されるようにエラーを処理します。

このサンプルの場所

このサンプルは、次の SDK の場所にあります。

<サンプルパス>\管理\ExplorerOM\DeleteParty\

次の表は、このサンプルのファイルとその目的を示しています。

ファイル	説明
App.ico、AssemblyInfo.cs、DeleteParty.csproj、DeleteParty.sln、DeleteParty.cs	指定したパーティを削除する Visual C# コマンドラインアプリケーションを構築するためのプロジェクト、ソリューション、およびソースファイル。

このサンプルを作成および初期化するには

Visual Studio で、ソリューションファイル DeleteParty.sln を開きます。
[ビルド] メニューの [ソリューションのビルド] をクリックします。

このサンプルを実行するには

コマンドウィンドウで、次のフォルダーに移動します。

<サンプルパス>\管理\ExplorerOM\DeleteParty\bin\Debug\
ファイル DeleteParty.exe を実行し、次の 2 つのコマンドライン引数の 1 つを渡します。
- <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 Server にあるすべてのパーティの一覧が表示されます。次に、スクリプトからの出力例を示します。

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 フォルダー)

次の方法で共有