Register-ServiceFabricApplicationType

Referentie

Module:: ServiceFabric

Hiermee wordt een Service Fabric-toepassingstype geregistreerd.

Syntax

Register-ServiceFabricApplicationType
        [-ApplicationPathInImageStore] <String>
        [-ApplicationPackageCleanupPolicy <ApplicationPackageCleanupPolicy>]
        [-Async]
        [-TimeoutSec <Int32>]
        [<CommonParameters>]

Register-ServiceFabricApplicationType
        [-ApplicationPackageDownloadUri] <Uri>
        -ApplicationTypeName <String>
        -ApplicationTypeVersion <String>
        [-Async]
        [-TimeoutSec <Int32>]
        [<CommonParameters>]

Description

De cmdlet Register-ServiceFabricApplicationType registreert een Service Fabric-toepassingstype. Lees meer over de implementatie van Service Fabric-toepassingen.

Het toepassingspakket kan bestaan op een relatieve locatie in het afbeeldingsarchief of kan een sfpkg bestand zijn dat eerder is geüpload naar een externe locatie.

Wanneer u een relatief archiefpad gebruikt, moet het toepassingspakket bestaan in het installatiekopieënarchief. Het pakket kan worden gekopieerd naar het installatiekopiearchief met Copy-ServiceFabricApplicationPackage.

Wanneer u een sfpkg bestand uit een extern archief gebruikt, moet de inrichting de download-URI opgeven naar de locatie waar het sfpkg eerder is geüpload, evenals de informatie over het toepassingstype. Het sfpkg bestand is een zip-bestand dat het eerste toepassingspakket bevat en de extensie '.sfpkg' heeft. Binnen de zip kan het toepassingspakket worden gecomprimeerd of gedecomprimeerd. De compressie van het toepassingspakket in de zip wordt uitgevoerd bij code-, pakket- en gegevenspakketten.

Als u een sfpkgbestand wilt maken, begint u met een map die het oorspronkelijke toepassingspakket bevat. Comprimeer het pakket indien nodig met Copy-ServiceFabricApplicationPackage met switches -CompressPackage en -SkipCopy. Gebruik vervolgens een hulpprogramma om de map te zippen met de extensie '.sfpkg'. Gebruik bijvoorbeeld ZipFile.CreateFromDirectory in de map van het toepassingspakket.

Nadat u een toepassingstype hebt geregistreerd, kunt u de cmdlet New-ServiceFabricApplication gebruiken om een toepassingsexemplaren te maken. Gebruik de cmdlet Start-ServiceFabricApplicationUpgrade om een bestaande toepassing bij te werken.

Wanneer het toepassingstype met de opgegeven versie niet meer nodig is, kunt u de registratie ongedaan maken met de cmdlet Unregister-ServiceFabricApplicationType .

Als u Service Fabric-clusters wilt beheren, start u Windows PowerShell met behulp van de optie Uitvoeren als administrator. Voordat u een bewerking uitvoert op een Service Fabric-cluster, maakt u een verbinding met het cluster met behulp van de cmdlet Connect-ServiceFabricCluster .

Voorbeelden

Voorbeeld 1: Een toepassingstype registreren bij het relatieve pad van het afbeeldingsarchief

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "file:C:\SfDevCluster\Data\ImageStoreShare" -ApplicationPackagePathInImageStore "PersistentToDoListService"
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService"

Copy-ServiceFabricApplicationPackage kopieert het toepassingspakket in de map c:\work\PersistentToDoListService naar het installatiekopiearchief. Het pakket wordt gekopieerd naar het relatieve pad PersistentToDoListService in het afbeeldingsarchief.

De opdracht Register-ServiceFabricApplicationType registreert het toepassingstype dat is gevonden in het relatieve pad PersistentToDoListService.

Voorbeeld 2: Een toepassingstype registreren bij het relatieve pad van de afbeeldingsopslag asynchroon

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService" -CompressPackage
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -Async
PS C:\> Get-ServiceFabricApplicationType

Copy-ServiceFabricApplicationPackage kopieert het toepassingspakket in de map c:\work\PersistentToDoListService naar het installatiekopiearchief. Het toepassingspakket wordt gekopieerd naar het relatieve pad PersistentToDoListService in het afbeeldingsarchief. De cmdlet maakt gebruik van compressie om de pakketgrootte te verkleinen.

De opdracht Register-ServiceFabricApplicationType registreert het toepassingstype dat is gevonden in het relatieve pad PersistentToDoListService. Registreren wordt asynchroon uitgevoerd en wordt geretourneerd zodra de opdracht wordt geaccepteerd door het cluster.

Get-ServiceFabricApplicationType haalt de toepassingstypen op die zijn geregistreerd in het cluster. Elk toepassingstype bevat de registratiestatus. De cmdlet kan worden gebruikt om te bepalen wanneer de registratie is voltooid.

Voorbeeld 3: Een toepassingstype registreren voor een groot toepassingspakket met het relatieve pad van de installatiekopieopslag

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService" -ImageStoreConnectionString "fabric:ImageStore" -ApplicationPackagePathInImageStore "PersistentToDoListService" -CompressPackage -TimeoutSec 2700
PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -TimeoutSec 2700

Copy-ServiceFabricApplicationPackage kopieert het toepassingspakket in de map c:\work\PersistentToDoListService naar het afbeeldingsarchief, op de relatieve locatie van de installatiekopieopslag persistentToDoListService. Omdat het eerste pakket erg groot is, comprimeert de opdracht het en bevat een hogere time-out om voldoende tijd voor het kopiëren toe te staan.

De opdracht Register-ServiceFabricApplicationType registreert het toepassingstype dat is gevonden in het relatieve pad PersistentToDoListService. De opdracht bevat een hogere time-out, zodat het werk kan worden voltooid, zelfs als het toepassingspakket groot is.

Voorbeeld 4: Een toepassingstype registreren vanuit een extern archief

PS C:\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri "https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -TimeoutSec 2700

Registreert het toepassingspakket dat is gevonden op de opgegeven URI. Het toepassingspakket moet eerder op die locatie zijn geüpload en leestoegang toestaan. Omdat het pakket groot kan zijn, geeft de opdracht een grote time-out voor de inrichting op.

Voorbeeld 5: Een toepassingstype registreren vanuit een extern archief asynchroon

PS C:\> Register-ServiceFabricApplicationType -ApplicationPackageDownloadUri "https://sftestresources.blob.core.windows.net:443/sfpkgholder/MyAppPackage.sfpkg" -ApplicationTypeName MyApp -ApplicationTypeVersion V1 -Async
PS C:\> Get-ServiceFabricApplicationType -ApplicationTypeName MyApp -ApplicationTypeVersion V1

Registreert het toepassingspakket dat is gevonden op de opgegeven URI. Het toepassingspakket moet eerder op die locatie zijn geüpload en leestoegang toestaan. Omdat -Async is opgegeven, wordt de opdracht geretourneerd zodra het cluster het accepteert. Get-ServiceFabricApplicationType haalt de toepassingstypen op die zijn geregistreerd in het cluster dat overeenkomt met het filter. Elk toepassingstype bevat de registratiestatus. De cmdlet kan worden gebruikt om de voortgang van de registratie te volgen en te bepalen wanneer de registratie is voltooid.

Voorbeeld 6: Een toepassingstype registreren met het relatieve pad van het afbeeldingsarchief en het automatisch opschonen van pakketten

PS C:\> Copy-ServiceFabricApplicationPackage -ApplicationPackagePath "c:\work\PersistentToDoListService"

PS C:\> Register-ServiceFabricApplicationType -ApplicationPathInImageStore "PersistentToDoListService" -ApplicationPackageCleanupPolicy Automatic

[Copy-ServiceFabricApplicationPackage](./Copy-ServiceFabricApplicationPackage.yml) copies the application package found in the "c:\work\PersistentToDoListService" folder to the image store. The package is copied at the relative path "PersistentToDoListService" in image store.

[Register-ServiceFabricApplicationType](./Register-ServiceFabricApplicationType.yml) command registers the application type found in the relative path "PersistentToDoListService" and deletes the application package "PersistentToDoListService" in the image store after successfully registering the application type. Deleting the application package from the image store after [Register-ServiceFabricApplicationType](./Register-ServiceFabricApplicationType.yml) command is recommended because it removes the temporary package as soon as it's not needed, which ensures that disk space is not consumed unnecessarily.

Parameters

-ApplicationPackageCleanupPolicy

Bepaalt het opschoningsbeleid van het toepassingspakket dat wordt gebruikt voor het registreren van het toepassingstype. Als deze niet zijn opgeschoond, verbruiken de toepassingspakketten schijfruimte en kunnen deze leiden tot fouten. Met deze parameter wordt aangegeven hoe u het toepassingspakket beheert nadat het toepassingstype is geregistreerd (geslaagde inrichting).

Wanneer deze is ingesteld Automaticop, bepaalt Service Fabric Runtime wanneer het opschonen van het toepassingspakket moet worden uitgevoerd. De huidige runtime-implementatie verwijdert het toepassingspakket nadat het toepassingstype is geregistreerd. Als de registratie mislukt, wordt het toepassingspakket niet verwijderd uit het installatiekopieënarchief.

Als dit is ingesteld Manualop, wordt het toepassingspakket niet verwijderd uit het installatiekopieënarchief en moeten de gebruikers de cmdlet Remove-ServiceFabricApplicationPackage expliciet aanroepen om het uit het installatiekopieënarchief te verwijderen.

Een Service Fabric-cluster is geconfigureerd met een opschoonbeleid. Als u het beleid van het cluster wilt gebruiken, geeft u Default de optie op. De clusterconfiguratie CleanupApplicationPackageOnProvisionSuccess onder Management sectie bepaalt hoe het opschonen moet plaatsvinden. Als deze optie is ingesteld op true, worden de toepassingspakketten automatisch verwijderd door de Service Fabric-runtime na een geslaagde inrichting. Als deze optie is ingesteld op false, wordt het toepassingspakket niet verwijderd uit het installatiekopieënarchief. De standaardwaarde van deze clusterconfiguratie is ingesteld op onwaar tot v6.4, maar er zijn plannen om deze in te stellen op waar voor toekomstige releases.

Type:	ApplicationPackageCleanupPolicy
Accepted values:	Invalid, Default, Automatic, Manual
Position:	Named
Default value:	Default
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationPackageDownloadUri

Vertegenwoordigt het pad naar het sfpkg toepassingspakket van waaruit het toepassingspakket kan worden gedownload met behulp van HTTP- of HTTPS-protocollen. Het pakket moet eerder zijn geüpload naar deze externe locatie. De URI moet LEEStoegang toestaan, zodat Service Fabric het bestand kan downloaden. Het sfpkg bestand is een zip-bestand dat het eerste toepassingspakket bevat. Binnen de zip kan het toepassingspakket worden gecomprimeerd of gedecomprimeerd. De compressie van het toepassingspakket in de zip wordt uitgevoerd bij code-, pakket- en gegevenspakketten. Deze compressie kan worden bereikt met copy-ServiceFabricApplicationPackage met switch -CompressPackage. Het sfpkg bestand moet de extensie '.sfpkg' hebben.

Type:	Uri
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationPathInImageStore

Hiermee geeft u het relatieve pad van het toepassingstypepakket in het afbeeldingsarchief op. Dit pad is opgegeven door de cmdlet Copy-ServiceFabricApplicationPackage toen het toepassingspakket werd gekopieerd naar het installatiekopiearchief.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationTypeName

Hiermee geeft u de naam van het toepassingstype op, zoals deze is gedefinieerd in het toepassingsmanifest. De naam van het toepassingstype en de versie van het toepassingstype identificeren het toepassingstype op unieke wijze. Dit is nodig bij het inrichten van een sfpkg externe winkel.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationTypeVersion

Hiermee geeft u de versie van het toepassingstype op, zoals deze is gedefinieerd in het toepassingsmanifest. De naam van het toepassingstype en de versie van het toepassingstype identificeren het toepassingstype op unieke wijze. Dit is nodig bij het inrichten van een sfpkg toepassingspakketbestand vanuit een extern archief.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Async

De opdracht wordt geretourneerd zodra de registratieaanvraag door het cluster wordt geaccepteerd. Gebruik de opdracht Get-ServiceFabricApplicationType om de status van de registratieaanvraag op te vragen. Het gebruik van deze switch voorkomt dat u grote TimeoutSec-waarden moet opgeven bij het registreren van grote toepassingspakketten.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeoutSec

Hiermee geeft u de time-outperiode, in seconden, voor de bewerking op.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

None

Uitvoerwaarden

System.Object