Unregister-ServiceFabricApplicationType

Referenz

Modul:: ServiceFabric

Hebt die Registrierung eines Service Fabric-Anwendungstyps auf.

Syntax

Unregister-ServiceFabricApplicationType
          [-ApplicationTypeName] <String>
          [-ApplicationTypeVersion] <String>
          [-Async]
          [-Force]
          [-TimeoutSec <Int32>]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Beschreibung

Das Cmdlet "Unregister-ServiceFabricApplicationType" die Registrierung eines Service Fabric-Anwendungstyps aufgehoben. Der Anwendungstyp muss zuvor bei Register-ServiceFabricApplicationTyperegistriert worden sein.

Bevor Sie die Registrierung eines Anwendungstyps aufheben, müssen Sie das Cmdlet Remove-ServiceFabricService verwenden, um Dienste zu entfernen, die Sie auf der Anwendung basieren. Verwenden Sie die Remove-ServiceFabricApplication Cmdlet, um Instanzen des Anwendungstyps zu entfernen. Wenn Sie die Registrierung eines Anwendungstyps aufheben, wird das Anwendungspaket aus dem Imagespeicher entfernt.

Um Service Fabric-Cluster zu verwalten, starten Sie Windows PowerShell mithilfe der Option "Als Administrator ausführen". Bevor Sie einen Vorgang auf einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Aufheben der Registrierung eines Anwendungstyps

PS C:\> Unregister-ServiceFabricApplicationType -ApplicationTypeName "CalcServiceApp" -ApplicationTypeVersion "1.0" -Force

Mit diesem Befehl wird die Registrierung des Anwendungstyps CalcServiceApp mit Version 1.0 aufgehoben. Wenn der Befehl erfolgreich zurückgibt, wurde die Registrierung des Anwendungstyps erfolgreich aufgehoben. Da der Befehl den Parameter Force enthält, werden Sie vom Cmdlet nicht zur Bestätigung aufgefordert.

Beispiel 2: Aufheben der Registrierung eines Anwendungstyps asynchron

PS C:\> Unregister-ServiceFabricApplicationType -ApplicationTypeName "CalcServiceApp" -ApplicationTypeVersion "1.0" -Async
PS C:\> Get-ServiceFabricApplicationType -ApplicationTypeName "CalcServiceApp" -ApplicationTypeVersion "1.0"

Unregister-ServiceFabricApplicationType die Bereitstellung des Anwendungstyps CalcServiceApp mit Version 1.0 beginnt. Da die option -Async bereitgestellt wird, wird der Befehl zurückgegeben, sobald der Cluster die Anforderung empfängt. Get-ServiceFabricApplicationType ruft die im Cluster registrierten Anwendungstypen mit dem angegebenen Filter ab. Die zurückgegebenen Anwendungstypen (falls vorhanden) enthalten den Registrierungsstatus. Das Cmdlet kann verwendet werden, um den Fortschritt für die Aufhebung der Bereitstellung anzuzeigen. Wenn die Registrierung des Anwendungstyps mit der angegebenen Version erfolgreich aufgehoben wurde, wird er nicht im Get-ServiceFabricApplicationType Ausgabe angezeigt.

Parameter

-ApplicationTypeName

Gibt den Namen eines Service Fabric-Anwendungstyps an. Das Cmdlet hebt die Registrierung des angegebenen Typs auf.

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ApplicationTypeVersion

Gibt die Version eines Service Fabric-Anwendungstyps an. Das Cmdlet hebt die Registrierung des Typs auf, der über die von Ihnen angegebene Version verfügt.

Typ:	String
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Async

Der Befehl wird zurückgegeben, sobald die Registrierungsanforderung vom Cluster akzeptiert wird. Verwenden Sie den Befehl Get-ServiceFabricApplicationType, um den Status der Anforderung abzufragen. Wenn Sie den asynchronen Switch übergeben, müssen Sie die -TimeoutSec für große Anwendungspakete nicht erhöhen.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-TimeoutSec

Gibt den Timeoutzeitraum für den Vorgang in Sekunden an.

Typ:	Int32
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

System.String

Ausgaben

System.Object