New-ServiceFabricServiceFromTemplate
Jeśli manifest aplikacji zdefiniował sekcję szablonów usług, to polecenie może służyć do tworzenia nowych usług z parametrami opisu usługi wypełnionymi na podstawie szablonu.
Składnia
New-ServiceFabricServiceFromTemplate
[-ApplicationName] <Uri>
[-ServiceName] <Uri>
[-ServiceTypeName] <String>
[-Force]
[-ServicePackageActivationMode <ServicePackageActivationMode>]
[-ServiceDnsName <String>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Opis
New-ServiceFabricService ma kilka obowiązkowych parametrów opisujących tworzoną usługę. Szablony usług w manifeście aplikacji mogą służyć do określania parametrów opisu usługi dla poszczególnych typów usług. Schemat opisu usługi w sekcji szablonu usługi jest taki sam jak schemat opisu usługi dla usług domyślnych. Umożliwia to tworzenie nowych usług określonego typu usługi bez określania parametrów, które w przeciwnym razie byłyby obowiązkowe dla New-ServiceFabricService.
Usługi utworzone przy użyciu szablonu usługi zachowują się identycznie z usługami utworzonymi przy użyciu New-ServiceFabricService. Można je uaktualnić, zaktualizować i usunąć przy użyciu tych samych przepływów pracy.
Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric ustanów połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster.
Przykłady
Przykład 1. Tworzenie usługi na podstawie szablonu usługi
Biorąc pod uwagę następujące manifesty aplikacji i usługi:
<?xml version="1.0" encoding="utf-8" ?>
<ApplicationManifest
ApplicationTypeName="MyApplicationType"
ApplicationTypeVersion="AppManifestVersion1"
xmlns="http://schemas.microsoft.com/2011/01/fabric"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Description>An example application manifest</Description>
<ServiceManifestImport>
<ServiceManifestRef ServiceManifestName="MyServiceManifest" ServiceManifestVersion="SvcManifestVersion1"/>
</ServiceManifestImport>
<ServiceTemplates>
<StatelessService ServiceTypeName="MyServiceType" InstanceCount="-1">
<SingletonPartition/>
</StatelessService>
</ServiceTemplates>
</ApplicationManifest>
<?xml version="1.0" encoding="utf-8" ?>
<ServiceManifest Name="MyServiceManifest" Version="SvcManifestVersion1" xmlns="http://schemas.microsoft.com/2011/01/fabric" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Description>An example service manifest</Description>
<ServiceTypes>
<StatelessServiceType ServiceTypeName="MyServiceType" />
</ServiceTypes>
<CodePackage Name="MyCode" Version="CodeVersion1">
<EntryPoint>
<ExeHost>
<Program>MyServiceHost.exe</Program>
</ExeHost>
</EntryPoint>
</CodePackage>
</ServiceManifest>
Następujące polecenie tworzy usługę Service Fabric przy użyciu szablonu usługi dla typu usługi MyServiceType zdefiniowane w manifeście aplikacji:
PS C:> New-ServiceFabricServiceFromTemplate -ApplicationName fabric:/myapp -ServiceName fabric:/myapp/myservice1 -ServiceTypeName MyServiceType
Można utworzyć wiele wystąpień usługi przy użyciu tego samego szablonu usługi. Po dodatkowym uruchomieniu następującego polecenia istnieją dwie jednotonowe usługi bezstanowe typu MyServiceType:
PS C:> New-ServiceFabricServiceFromTemplate -ApplicationName fabric:/myapp -ServiceName fabric:/myapp/myservice2 -ServiceTypeName MyServiceType
Parametry
-ApplicationName
Określa identyfikator URI (Uniform Resource Identifier) aplikacji usługi Service Fabric w celu utworzenia usługi.
Typ: | Uri |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Force
Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ServiceDnsName
{{Fill ServiceDnsName Description}}
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ServiceName
Określa identyfikator URI usługi Service Fabric.
Typ: | Uri |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ServicePackageActivationMode
Steruje [modelem hostingu][1], który ma być używany dla usługi. Prawidłowe wartości to SharedProcess i ExclusiveProcess. Wartość domyślna to SharedProcess.
W przypadku trybu aktywacji SharedProcess repliki (lub wystąpienia) różnych usług danego ServiceType będą współdzielić te same ServiceHost. W trybie aktywacji
Typ: | ServicePackageActivationMode |
Dopuszczalne wartości: | SharedProcess, ExclusiveProcess |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ServiceTypeName
Określa nazwę typu usługi Service Fabric, dla którego istnieje szablon usługi zdefiniowany w manifeście aplikacji.
Typ: | String |
Position: | 2 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-TimeoutSec
Określa limit czasu dla operacji w sekundach.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
None
Dane wyjściowe
System.Object