次の方法で共有

New-ServiceFabricServiceFromTemplate

  • リファレンス
モジュール:
ServiceFabric

アプリケーション マニフェストでサービス テンプレート セクションが定義されている場合、このコマンドを使用して、テンプレートから設定されたサービス記述パラメーターを使用して新しいサービスを作成できます。

構文

New-ServiceFabricServiceFromTemplate
   [-ApplicationName] <Uri>
   [-ServiceName] <Uri>
   [-ServiceTypeName] <String>
   [-Force]
   [-ServicePackageActivationMode <ServicePackageActivationMode>]
   [-ServiceDnsName <String>]
   [-TimeoutSec <Int32>]
   [<CommonParameters>]

説明

New-ServiceFabricService には、作成されるサービスを記述するいくつかの必須パラメーターがあります。 アプリケーション マニフェストのサービス テンプレートを使用して、サービスの種類ごとにサービス記述パラメーターを指定できます。 サービス テンプレート セクションのサービス記述スキーマは、既定のサービスのサービス記述スキーマ 同じです。 これにより、New-ServiceFabricServiceに必須であったパラメーターを指定せずに、特定のサービスの種類の新しいサービスを作成できます。

サービス テンプレートを使用して作成されたサービスは、New-ServiceFabricServiceを使用して作成されたサービスと同じように動作します。 これらは、同じワークフローを使用してアップグレード、更新、および削除できます。

Service Fabric クラスターで操作を実行する前に、Connect-ServiceFabricCluster コマンドレットを使用してクラスターへの接続を確立します。

例

例 1: サービス テンプレートからサービスを作成する

次のアプリケーション マニフェストとサービス マニフェストが考えられます。

<?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>

次のコマンドは、アプリケーション マニフェストで定義されているサービスの種類 MyServiceType サービス テンプレートを使用して Service Fabric サービスを作成します。

PS C:> New-ServiceFabricServiceFromTemplate -ApplicationName fabric:/myapp -ServiceName fabric:/myapp/myservice1 -ServiceTypeName MyServiceType

同じサービス テンプレートを使用して、複数のサービス インスタンスを作成できます。 さらに、次のコマンドを実行すると、MyServiceType2 つのシングルトン ステートレス サービスがあります。

PS C:> New-ServiceFabricServiceFromTemplate -ApplicationName fabric:/myapp -ServiceName fabric:/myapp/myservice2 -ServiceTypeName MyServiceType

パラメーター

-ApplicationName

サービスを作成する Service Fabric アプリケーションの URI (Uniform Resource Identifier) を指定します。

型:Uri
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServiceDnsName

{{Fill ServiceDnsName Description}}

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServiceName

Service Fabric サービスの URI を指定します。

型:Uri
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServicePackageActivationMode

サービスに使用する [ホスティング モデル][1] を制御します。 有効な値は、SharedProcess と ExclusiveProcessです。 既定値は SharedProcessです。

SharedProcess アクティブ化モード 場合、特定の ServiceType のさまざまなサービスのレプリカ (またはインスタンス) は、ServiceHost同じを共有します。 ExclusiveProcess アクティブ化モード 場合、サービスの各レプリカまたはインスタンスには、ServiceHost専用 があります。 詳細については、[Service Fabric ホスティング モデル][1] を参照してください。

型:ServicePackageActivationMode
指定可能な値:SharedProcess, ExclusiveProcess
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServiceTypeName

アプリケーション マニフェストで定義されているサービス テンプレートがある Service Fabric サービスの種類の名前を指定します。

型:String
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-TimeoutSec

操作のタイムアウト期間を秒単位で指定します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

System.Object