DeleteParty (Löschen der Partei – BizTalk Server-Beispiel)

Artikel
05/04/2023

Im Beispiel „DeleteParty“ wird gezeigt, wie eine bestimmte Partei gelöscht wird.

Warnung

Bereitstellungsskripts sollten nach einer Bereitstellung entfernt werden (wenn sie nicht mehr benötigt werden). Verwaltungsskripts und andere Skripts, die vorhanden sein müssen, sollten über die Zugriffssteuerungsliste geschützt und genau überwacht werden.

Hinweis

Bevor Sie eine Partei löschen können, muss sie zunächst erstellt werden. Hierzu können Sie das Beispiel PartyResolution (BizTalk Server Beispiel) ausführen.

Voraussetzungen

Sie müssen über BizTalk Server Administratorrechte verfügen, um die Administrativen Objekte in diesem Beispiel verwenden zu können.
Für die Skriptausführung erfordert das Windows PowerShell-Skript die Windows PowerShell-Ausführungsrichtlinie. Weitere Informationen finden Sie unter about_Execution_Policies.

Ziel des Beispiels

In diesem in Microsoft Visual C# geschriebenen Beispiel, in dem Objekte aus dem BizTalk Explorer-Objektmodell (ExplorerOM) verwendet werden, werden die folgenden Operationen ausgeführt:

Abfragen nach einer angegebenen Partei
Löschen der Partei
Behandeln von Fehlern, damit sinnvolle Informationen an den Benutzer zurückgegeben werden

Speicherort dieses Beispiels

Dieses Beispiel befindet sich am folgenden SDK-Speicherort:

<Beispielpfad>\Admin\ExplorerOM\DeleteParty\

In der folgenden Tabelle werden die Dateien in diesem Beispiel samt Zweck beschrieben.

Datei(en)	BESCHREIBUNG
App.ico, AssemblyInfo.cs, DeleteParty.csproj, DeleteParty.sln, DeleteParty.cs	Projekt-, Projektmappen- und Quelldateien zum Erstellen einer Visual C#-Befehlszeilenanwendung, mit der eine angegebene Partei entfernt wird.

So erstellen und initialisieren Sie dieses Beispiel

Öffnen Sie in Visual Studio die Projektmappendatei DeleteParty.sln.
Klicken Sie im Menü Erstellen auf Projektmappe erstellen.

So führen Sie dieses Beispiel aus

Navigieren Sie in einem Befehlsfenster zum folgenden Ordner:

<Beispielpfad>\Admin\ExplorerOM\DeleteParty\bin\Debug\
Führen Sie die Datei DeleteParty.exe aus, und übergeben Sie dabei eines der beiden folgenden Befehlszeilenargumente:
- <PartyName>. Der Name einer zu löschenden Partei. Wenn der Parteiname Leerzeichen enthält, muss er in Anführungszeichen eingeschlossen werden.
- /?. Zeigt die Hilfe an.
  
  Beispiel:
```
DeleteParty "My Party #3"
```
ODER
```
DeleteParty /?
```

Windows PowerShell-Skriptbeispiel

Das folgende Windows PowerShell Skriptfragment kann verwendet werden, um die gleichen Features der ExplorerOM-Klassen zu veranschaulichen:


#===================#
#=== 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()
}

Beim Skriptbeispiel wird erwartet, dass ein einzelner Parteiname als Befehlszeilenargument übergeben werden muss. Nach dieser Partei wird nach Name gesucht, und es wird versucht, die Datei zu löschen. Im Skript werden alle Parteien auf dem lokalen BizTalk-Server aufgelistet, wenn daran kein Argument commandline übergeben wird. Hier eine Beispielausgabe aus dem Skript:

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

Weitere Informationen

Admin\ExplorerOM (Ordner für BizTalk Server-Beispiele)

Freigeben über