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