New-ServiceFabricApplication

Crea un'applicazione di Service Fabric.

Sintassi

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

Descrizione

Il cmdlet New-ServiceFabricApplication crea un'applicazione di Service Fabric di un tipo di applicazione registrato. Usare il cmdlet Register-ServiceFabricApplicationType per registrare un tipo di applicazione.

Prima di eseguire qualsiasi operazione in un cluster di Service Fabric, stabilire una connessione al cluster usando il cmdlet Connect-ServiceFabricCluster .

Esempio

Esempio 1: creare un'applicazione

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

Questo comando crea un'applicazione del tipo PersistentToDoListApp. L'applicazione è la versione 1.0. Il tipo di applicazione e la versione provengono dal manifesto dell'applicazione nel pacchetto dell'applicazione usato durante la registrazione dell'applicazione usando il cmdlet Register-ServiceFabricApplicationType .

Esempio 2: Creare un'applicazione eseguendo l'override dei valori predefiniti dei parametri nel manifesto dell'applicazione

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

Questo comando crea un'applicazione del tipo PersistentToDoListApp e versione 1.0 con valori sottoposti a override per i parametri CustomParameter1 e CustomParameter2. Questi nomi di parametri devono esistere nel manifesto dell'applicazione del pacchetto dell'applicazione usato durante la registrazione dell'applicazione usando il cmdlet Register-ServiceFabricApplicationType .

Parametri

-ApplicationName

Specifica l'URI (Uniform Resource Identifier) di un'applicazione di Service Fabric. Il cmdlet crea un'applicazione di Service Fabric con il nome specificato.

Tipo:Uri
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplicationParameter

Specifica gli overridi per i parametri dell'applicazione definiti nel manifesto dell'applicazione come coppie chiave/valore. Il cmdlet crea un'applicazione di Service Fabric del tipo di applicazione e usa i valori sottoposti a override per questi parametri. I parametri sottoposti a override devono esistere nel manifesto dell'applicazione.

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplicationTypeName

Specifica il nome di un tipo di applicazione di Service Fabric. Il cmdlet crea un'applicazione di Service Fabric del tipo di applicazione specificato.

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplicationTypeVersion

Specifica la versione di un tipo di applicazione di Service Fabric. Il cmdlet crea un'applicazione con la versione specificata.

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaximumNodes

Specifica il numero massimo di nodi in cui inserire un'applicazione. Il valore di questo parametro deve essere un intero non negativo. Il valore predefinito è 0, che indica che l'applicazione può essere posizionata su qualsiasi numero di nodi nel cluster.

Tipo:Int64
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Metrics

Specifica una matrice di metriche. Queste metriche vengono usate dal cluster di Service Fabric Resource Manager per gestire le risorse nel cluster. Per altre informazioni sulle metriche e sulla gestione delle risorse in Service Fabric, vedere Introduzione Resource Manager al cluster di Service Fabric. Ogni metrica può seguire il modello MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity o può specificare MetricName e usare i nomi dei parametri NodeReservationCapacity, MaximumNodeCapacity o TotalApplicationCapacity seguiti da un valore di parametro e separati da due punti. Ogni coppia nome parametro:value può essere visualizzata al massimo.

  • MetricName. Specifica il nome della metrica.
  • NodeReservationCapacity. Specifica la quantità di carico delle metriche riservata nei nodi con istanze di questa applicazione. Se viene specificato MinimumNodes , il prodotto di questi valori è la capacità riservata nel cluster per l'applicazione.
  • MaximumNodeCapacity. Specifica il carico massimo per un'istanza di questa applicazione in un singolo nodo. Anche se la capacità del nodo è maggiore di questo valore, Service Fabric limita il carico totale delle repliche figlio dell'applicazione a questo valore.
  • TotalApplicationCapacity. Specifica la capacità totale per l'applicazione nel cluster. Service Fabric tenta di limitare la somma dei carichi di repliche figlio dell'applicazione a questo valore.

Durante la creazione dell'applicazione, Service Fabric esegue le convalida seguenti e avrà esito negativo se non passano:

  • NodeReservationCapacity non deve essere maggiore di MaximumNodeCapacity.

  • Se viene specificata la metrica MinimumNodes e NodeReservationCapacity, il prodotto di MinimumNodes e NodeReservationCapacity non deve essere maggiore di TotalApplicationCapacity. Per altre informazioni, vedere Metriche dell'applicazione, carico e capacità

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MinimumNodes

Specifica il numero minimo di nodi in cui Service Fabric riserva la capacità per questa applicazione, ciò non significa che l'applicazione sia garantita di avere repliche in tutti questi nodi. Il valore di questo parametro deve essere un intero non negativo. Il valore predefinito per questo valore è zero, ovvero nessuna capacità è riservata all'applicazione.

Tipo:Int64
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimeoutSec

Specifica il periodo di timeout, in secondi, per l'operazione.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

System.Object