New-ServiceFabricServiceFromTemplate
如果應用程式指令清單已定義服務範本區段,則此命令可用來建立新的服務,其中包含從範本填入的服務描述參數。
語法
New-ServiceFabricServiceFromTemplate
[-ApplicationName] <Uri>
[-ServiceName] <Uri>
[-ServiceTypeName] <String>
[-Force]
[-ServicePackageActivationMode <ServicePackageActivationMode>]
[-ServiceDnsName <String>]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Description
New-ServiceFabricService 具有數個描述所建立服務的必要參數。 應用程式指令清單中的服務範本可用來指定每個服務類型的服務描述參數。 服務範本區段中的服務描述架構與 預設服務的服務描述架構相同,。 這允許建立特定服務類型的新服務,而不需要指定參數,否則為 New-ServiceFabricService 的必要參數。
使用服務範本建立的服務的行為與使用 New-ServiceFabricService
在 Service Fabric 叢集上執行任何作業之前,請使用 Connect-ServiceFabricCluster Cmdlet 來建立叢集的連線。
範例
範例 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
您可以使用相同的服務範本來建立多個服務實例。 另外執行下列命令之後,MyServiceType 類型有兩個單一無狀態服務 :
PS C:> New-ServiceFabricServiceFromTemplate -ApplicationName fabric:/myapp -ServiceName fabric:/myapp/myservice2 -ServiceTypeName MyServiceType
參數
-ApplicationName
指定要在中建立服務的 Service Fabric 應用程式的統一資源識別碼(URI)。
類型: | Uri |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-Force
強制命令執行,而不要求使用者確認。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ServiceDnsName
{{Fill ServiceDnsName Description}}
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ServiceName
指定 Service Fabric 服務的 URI。
類型: | Uri |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-ServicePackageActivationMode
控制要用於服務的 [裝載模型][1]。 有效值為 SharedProcess 和 ExclusiveProcess。 預設值為 SharedProcess。
使用
類型: | ServicePackageActivationMode |
接受的值: | SharedProcess, ExclusiveProcess |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ServiceTypeName
指定 Service Fabric 服務類型的名稱,其中已定義於應用程式指令清單中的服務範本。
類型: | String |
Position: | 2 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-TimeoutSec
指定作業的逾時期間,以秒為單位。
類型: | Int32 |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
System.Object