New-ServiceFabricApplication

  • Referentie
Module:
ServiceFabric

Hiermee maakt u een Service Fabric-toepassing.

Syntax

New-ServiceFabricApplication
   [-ApplicationName] <Uri>
   [-ApplicationTypeName] <String>
   [-ApplicationTypeVersion] <String>
   [-ApplicationParameter <Hashtable>]
   [-MaximumNodes <Int64>]
   [-MinimumNodes <Int64>]
   [-Metrics <String[]>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

Description

Met de cmdlet New-ServiceFabricApplication maakt u een Service Fabric-toepassing van een geregistreerd toepassingstype. Gebruik de cmdlet Register-ServiceFabricApplicationType om een toepassingstype te registreren.

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 toepassing maken

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"

Met deze opdracht maakt u een toepassing van het type PersistentToDoListApp. De toepassing is versie 1.0. Het toepassingstype en de versie zijn afkomstig uit het toepassingsmanifest in het toepassingspakket dat is gebruikt bij het registreren van de toepassing met de cmdlet Register-ServiceFabricApplicationType .

Voorbeeld 2: Een toepassing maken door standaardparameterwaarden in het toepassingsmanifest te overschrijven

PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}

Met deze opdracht maakt u een toepassing van het type PersistentToDoListApp en versie 1.0 met overschreven waarden voor parameters CustomParameter1 en CustomParameter2. Deze parameternamen moeten aanwezig zijn in het toepassingsmanifest van het toepassingspakket dat is gebruikt bij het registreren van de toepassing met de cmdlet Register-ServiceFabricApplicationType .

Parameters

-ApplicationName

Hiermee geeft u de URI (Uniform Resource Identifier) van een Service Fabric-toepassing op. De cmdlet maakt een Service Fabric-toepassing met de naam die u opgeeft.

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

-ApplicationParameter

Hiermee geeft u de onderdrukkingen op voor toepassingsparameters die zijn gedefinieerd in het toepassingsmanifest als sleutel-waardeparen. De cmdlet maakt een Service Fabric-toepassing van het toepassingstype en gebruikt de genegeerde waarden voor deze parameters. De parameters die hier worden overschreven, moeten aanwezig zijn in het toepassingsmanifest.

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

-ApplicationTypeName

Hiermee geeft u de naam van een Service Fabric-toepassingstype. De cmdlet maakt een Service Fabric-toepassing van het toepassingstype dat u opgeeft.

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

-ApplicationTypeVersion

Hiermee geeft u de versie van een Service Fabric-toepassingstype op. De cmdlet maakt een toepassing met de versie die u opgeeft.

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

-MaximumNodes

Hiermee geeft u het maximum aantal knooppunten op waarop een toepassing moet worden geïnstalleerd. De waarde van deze parameter moet een niet-negatief geheel getal zijn. De standaardwaarde is 0, wat aangeeft dat de toepassing op een willekeurig aantal knooppunten in het cluster kan worden geplaatst.

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

-Metrics

Hiermee geeft u een matrix met metrische gegevens op. Deze metrische gegevens worden gebruikt door Service Fabric-cluster Resource Manager om resources in het cluster te beheren. Zie Service Fabric-cluster Resource Manager Inleiding voor meer informatie over metrische gegevens en resourcebeheer in Service Fabric. Elke metrische waarde kan het patroon MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity volgen of metricName opgeven en parameternamen NodeReservationCapacity, MaximumNodeCapacity of TotalApplicationCapacity gebruiken, gevolgd door een parameterwaarde en gescheiden door een dubbele punt. Elke parameternaam:waardepaar kan maximaal één keer worden weergegeven.

  • MetricName. Hiermee geeft u de naam van de metrische waarde.
  • NodeReservationCapacity. Hiermee geeft u de hoeveelheid metrische belasting op die is gereserveerd op knooppunten met exemplaren van deze toepassing. Als MinimumNodes is opgegeven, is het product van deze waarden de capaciteit die is gereserveerd in het cluster voor de toepassing.
  • MaximumNodeCapacity. Hiermee geeft u de maximale belasting voor een exemplaar van deze toepassing op één knooppunt. Zelfs als de capaciteit van het knooppunt groter is dan deze waarde, beperkt Service Fabric de totale belasting van de onderliggende replica's van de toepassing tot deze waarde.
  • TotalApplicationCapacity. Hiermee geeft u de totale capaciteit voor de toepassing in het cluster op. Service Fabric probeert de som van de belastingen van de onderliggende replica's van de toepassing tot deze waarde te beperken.

Tijdens het maken van de toepassing voert Service Fabric de volgende validaties uit en mislukt de opdracht als ze niet slagen:

  • NodeReservationCapacity mag niet meer zijn dan MaximumNodeCapacity.

  • Als zowel de parameter MinimumNodes als de meetwaarde NodeReservationCapacity zijn opgegeven, mag het product van MinimumNodes en NodeReservationCapacity niet meer zijn dan TotalApplicationCapacity. Zie Metrische toepassingsgegevens, belasting en capaciteit voor meer informatie

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

-MinimumNodes

Hiermee geeft u het minimum aantal knooppunten op waar Service Fabric capaciteit voor deze toepassing reserveert. Dit betekent niet dat de toepassing gegarandeerd replica's heeft op al deze knooppunten. De waarde van deze parameter moet een niet-negatief geheel getal zijn. De standaardwaarde hiervoor is nul, wat betekent dat er geen capaciteit is gereserveerd voor de toepassing.

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

-TimeoutSec

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

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

Invoerwaarden

None

Uitvoerwaarden

System.Object