New-ServiceFabricApplication
Tworzy aplikację usługi Service Fabric.
Składnia
New-ServiceFabricApplication
[-ApplicationName] <Uri>
[-ApplicationTypeName] <String>
[-ApplicationTypeVersion] <String>
[-ApplicationParameter <Hashtable>]
[-MaximumNodes <Int64>]
[-MinimumNodes <Int64>]
[-Metrics <String[]>]
[-TimeoutSec <Int32>]
[<CommonParameters>] Opis
Polecenie cmdlet New-ServiceFabricApplication tworzy aplikację usługi Service Fabric zarejestrowanego typu aplikacji. Użyj polecenia cmdlet Register-ServiceFabricApplicationType , aby zarejestrować typ aplikacji.
Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric nawiąż połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster .
Przykłady
Przykład 1. Tworzenie aplikacji
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"To polecenie tworzy aplikację typu PersistentToDoListApp. Aplikacja jest w wersji 1.0. Typ i wersja aplikacji pochodzą z manifestu aplikacji w pakiecie aplikacji, który został użyty podczas rejestrowania aplikacji przy użyciu polecenia cmdlet Register-ServiceFabricApplicationType .
Przykład 2. Tworzenie aplikacji przez zastąpienie domyślnych wartości parametrów w manifeście aplikacji
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}To polecenie tworzy aplikację typu PersistentToDoListApp i 1.0 z przesłoniętymi wartościami parametrów CustomParameter1 i CustomParameter2. Te nazwy parametrów muszą istnieć w manifeście aplikacji pakietu aplikacji, który został użyty podczas rejestrowania aplikacji przy użyciu polecenia cmdlet Register-ServiceFabricApplicationType .
Parametry
-ApplicationName
Określa identyfikator URI (Uniform Resource Identifier) aplikacji usługi Service Fabric. Polecenie cmdlet tworzy aplikację usługi Service Fabric o określonej nazwie.
| Type: | Uri |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationParameter
Określa przesłonięcia parametrów aplikacji zdefiniowanych w manifeście aplikacji jako pary klucz/wartość. Polecenie cmdlet tworzy aplikację usługi Service Fabric typu aplikacji i używa zastąpionych wartości dla tych parametrów. Parametry, które są zastępowane w tym miejscu, muszą istnieć w manifeście aplikacji.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeName
Określa nazwę typu aplikacji usługi Service Fabric. Polecenie cmdlet tworzy aplikację usługi Service Fabric określonego typu aplikacji.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeVersion
Określa wersję typu aplikacji usługi Service Fabric. Polecenie cmdlet tworzy aplikację, która ma wersję, którą określisz.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumNodes
Określa maksymalną liczbę węzłów, na których ma być umieszczana aplikacja. Wartość tego parametru musi być nieujemną liczbą całkowitą. Wartość domyślna to 0, co oznacza, że aplikację można umieścić w dowolnej liczbie węzłów w klastrze.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Metrics
Określa tablicę metryk. Te metryki są używane przez klaster usługi Service Fabric Resource Manager do zarządzania zasobami w klastrze. Aby uzyskać więcej informacji na temat metryk i zarządzania zasobami w usłudze Service Fabric, zobacz Service Fabric Cluster Resource Manager Introduction (Wprowadzenie do klastra usługi Service Fabric). Każda metryka może podążać za wzorcem MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity lub może określić nazwę MetricName i użyć nazw parametrów NodeReservationCapacity, MaximumNodeCapacity lub TotalApplicationCapacity , a następnie wartości parametru i rozdzielić dwukropkiem. Każda para parametrów name:value może być wyświetlana co najwyżej raz.
- MetricName. Określa nazwę metryki.
- NodeReservationCapacity. Określa ilość obciążenia metryki zarezerwowanego w węzłach, które mają wystąpienia tej aplikacji. Jeśli określono wartość MinimumNodes , produktem tych wartości jest pojemność zarezerwowana w klastrze dla aplikacji.
- MaximumNodeCapacity. Określa maksymalne obciążenie wystąpienia tej aplikacji w jednym węźle. Nawet jeśli pojemność węzła jest większa niż ta wartość, usługa Service Fabric ogranicza całkowite obciążenie replik podrzędnych aplikacji do tej wartości.
- TotalApplicationCapacity. Określa łączną pojemność aplikacji w klastrze. Usługa Service Fabric próbuje ograniczyć sumę obciążeń replik podrzędnych aplikacji do tej wartości.
Podczas tworzenia aplikacji usługa Service Fabric przeprowadza następujące walidacje i zakończy się niepowodzeniem polecenia, jeśli nie zostaną przekazane:
Wartość NodeReservationCapacity nie może przekraczać wartości MaximumNodeCapacity.
Jeśli określono zarówno parametr MinimumNodes , jak i metryki NodeReservationCapacity, produkt MinimumNodes i NodeReservationCapacity nie może być większy niż TotalApplicationCapacity. Aby uzyskać więcej informacji, zobacz Metryki aplikacji, obciążenie i pojemność
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumNodes
Określa minimalną liczbę węzłów, w których usługa Service Fabric będzie rezerwować pojemność dla tej aplikacji, nie oznacza to, że aplikacja ma gwarancję posiadania replik na wszystkich tych węzłach. Wartość tego parametru musi być nieujemną liczbą całkowitą. Wartość domyślna dla tej wartości to zero, co oznacza, że żadna pojemność nie jest zarezerwowana dla aplikacji.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutSec
Określa limit czasu dla operacji w sekundach.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Dane wejściowe
None
Dane wyjściowe
System.Object