New-ServiceFabricApplication
Létrehoz egy Service Fabric-alkalmazást.
Syntax
New-ServiceFabricApplication
[-ApplicationName] <Uri>
[-ApplicationTypeName] <String>
[-ApplicationTypeVersion] <String>
[-ApplicationParameter <Hashtable>]
[-MaximumNodes <Int64>]
[-MinimumNodes <Int64>]
[-Metrics <String[]>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
A New-ServiceFabricApplication parancsmag egy regisztrált alkalmazástípusú Service Fabric-alkalmazást hoz létre. A Register-ServiceFabricApplicationType parancsmaggal regisztrálhat egy alkalmazástípust.
Mielőtt bármilyen műveletet végrehajt egy Service Fabric-fürtön, hozzon létre kapcsolatot a fürttel a Connect-ServiceFabricCluster parancsmag használatával.
Példák
1. példa: Alkalmazás létrehozása
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"
Ez a parancs létrehoz egy PersistentToDoListApp típusú alkalmazást. Az alkalmazás 1.0-s verziójú. Az alkalmazás típusa és verziója abban az alkalmazáscsomagban található alkalmazásjegyzékből származik, amelyet az alkalmazás Register-ServiceFabricApplicationType parancsmaggal történő regisztrálásakor használt.
2. példa: Alkalmazás létrehozása az alapértelmezett paraméterértékek felülírásával az alkalmazásjegyzékben
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}
Ez a parancs létrehoz egy PersistentToDoListApp típusú és 1.0-s verziójú alkalmazást a CustomParameter1 és a CustomParameter2 paraméterek felüldírált értékeivel. Ezeknek a paraméterneveknek meg kell lenniük annak az alkalmazáscsomagnak az alkalmazásjegyzékében, amelyet az alkalmazás Register-ServiceFabricApplicationType parancsmaggal történő regisztrálásakor használtak.
Paraméterek
-ApplicationName
Egy Service Fabric-alkalmazás egységes erőforrás-azonosítóját (URI-ját) adja meg. A parancsmag létrehoz egy Service Fabric-alkalmazást a megadott névvel.
Type: | Uri |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationParameter
Megadja az alkalmazásjegyzékben kulcs/érték párként definiált alkalmazásparaméterek felülbírálásait. A parancsmag létrehoz egy alkalmazástípusú Service Fabric-alkalmazást, és ezekhez a paraméterekhez a felülírt értékeket használja. Az itt felül bírálandó paramétereknek létezniük kell az alkalmazásjegyzékben.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationTypeName
Egy Service Fabric-alkalmazástípus nevét adja meg. A parancsmag létrehoz egy, a megadott alkalmazástípusú Service Fabric-alkalmazást.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationTypeVersion
A Service Fabric-alkalmazástípus verzióját adja meg. A parancsmag létrehoz egy alkalmazást, amely a megadott verzióval rendelkezik.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumNodes
Meghatározza, hogy legfeljebb hány csomóponton helyezzen el egy alkalmazást. A paraméter értékének nem negatív egész számnak kell lennie. Az alapértelmezett érték 0, ami azt jelzi, hogy az alkalmazás tetszőleges számú csomóponton elhelyezhető a fürtben.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Metrics
Metrikák tömbje. Ezeket a metrikákat a Service Fabric-fürt Resource Manager használja a fürt erőforrásainak kezelésére. A Service Fabric metrikáiról és erőforrás-kezeléséről további információt a Service Fabric-fürt Resource Manager – bevezetés című témakörben talál. Minden metrika követheti a MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity mintát, vagy megadhatja a MetricName értéket, és használhatja a NodeReservationCapacity, MaximumNodeCapacity vagy TotalApplicationCapacity paraméternevet, amelyet egy paraméterérték követ, és kettősponttal elválasztva. Minden paraméternév:érték pár legfeljebb egyszer jelenhet meg.
- MetricName. Megadja a metrika nevét.
- NodeReservationCapacity. Az alkalmazás példányait tartalmazó csomópontokon lefoglalt metrikaterhelés mennyiségét határozza meg. Ha a minimumcsomópontok meg vannak adva, ezeknek az értékeknek a szorzata az alkalmazás számára a fürtben lefoglalt kapacitás.
- Maximális Csomópontkapacitás. Meghatározza az alkalmazás egy példányának maximális terhelését egyetlen csomóponton. Még ha a csomópont kapacitása is nagyobb ennél az értéknél, a Service Fabric az alkalmazás gyermekreplikáinak teljes terhelését erre az értékre korlátozza.
- TotalApplicationCapacity. Megadja a fürtben lévő alkalmazás teljes kapacitását. A Service Fabric megpróbálja az alkalmazás gyermekreplikáinak terheléseit erre az értékre korlátozni.
Az alkalmazás létrehozásakor a Service Fabric a következő ellenőrzéseket hajtja végre, és sikertelen lesz a parancs, ha nem adnak át:
A NodeReservationCapacity értéke nem lehet nagyobb a MaximumNodeCapacity értéknél.
Ha a MinimumNodes paraméter és a NodeReservationCapacity metrika is meg van adva, akkor a MinimumNodes és a NodeReservationCapacity szorzata nem lehet nagyobb, mint a TotalApplicationCapacity. További információ: Alkalmazásmetrikák, terhelés és kapacitás
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinimumNodes
Meghatározza azoknak a csomópontoknak a minimális számát, ahol a Service Fabric lefoglalja a kapacitást ehhez az alkalmazáshoz. Ez nem jelenti azt, hogy az alkalmazás garantáltan rendelkezik replikákkal az összes csomóponton. A paraméter értékének nem negatív egész számnak kell lennie. Ennek alapértelmezett értéke nulla, ami azt jelenti, hogy nincs kapacitás lefoglalva az alkalmazás számára.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeoutSec
A művelet időtúllépési időtartamát adja meg másodpercben.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Bevitelek
None
Kimenetek
System.Object