Udostępnij za pośrednictwem

New-ServiceFabricServiceFromTemplate

  • Odwołanie
Moduł:
ServiceFabric

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 domyślnych usług. 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 polecenia New-ServiceFabricService.

Usługi utworzone przy użyciu szablonu usługi zachowują się identycznie z usługami utworzonymi przy użyciu polecenia New-ServiceFabricService. Można je uaktualniać, aktualizować i usuwać przy użyciu tych samych przepływów pracy.

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 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 zdefiniowanego 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 pojedyncze 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 trybie aktywacji SharedProcess repliki (lub wystąpienia) różnych usług danego typu usługi będą współużytkują ten sam parametr ServiceHost. W trybie aktywacji ExclusiveProcess każda replika lub wystąpienie usługi będzie mieć własną dedykowaną usługę ServiceHost. Aby uzyskać więcej informacji, zobacz [Model hostingu usługi Service Fabric][1].

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