共用方式為


New-AzureRmServiceFabricCluster

此命令會使用您提供的憑證,或系統產生的自我簽署憑證來設定新的 Service Fabric 叢集。 它可以使用預設範本或您提供的自訂範本。 您可以選擇指定要匯出自我簽署憑證的資料夾,或稍後從密鑰保存庫擷取憑證。

警告

自 2024 年 2 月 29 日起,AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組,以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作,但不再維護或支援它,但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引,請參閱我們的 移轉資源

Syntax

New-AzureRmServiceFabricCluster
   [-ResourceGroupName] <String>
   [-CertificateOutputFolder <String>]
   [-CertificatePassword <SecureString>]
   [-KeyVaultResouceGroupName <String>]
   [-KeyVaultName <String>]
   -Location <String>
   [-Name <String>]
   [-VmUserName <String>]
   [-ClusterSize <Int32>]
   [-CertificateSubjectName <String>]
   -VmPassword <SecureString>
   [-OS <OperatingSystem>]
   [-VmSku <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmServiceFabricCluster
   [-ResourceGroupName] <String>
   -TemplateFile <String>
   -ParameterFile <String>
   [-VmPassword <SecureString>]
   -SecretIdentifier <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmServiceFabricCluster
   [-ResourceGroupName] <String>
   -TemplateFile <String>
   -ParameterFile <String>
   [-CertificateOutputFolder <String>]
   [-CertificatePassword <SecureString>]
   [-KeyVaultResouceGroupName <String>]
   [-KeyVaultName <String>]
   [-CertificateSubjectName <String>]
   [-VmPassword <SecureString>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzureRmServiceFabricCluster
   [-ResourceGroupName] <String>
   -TemplateFile <String>
   -ParameterFile <String>
   -CertificateFile <String>
   [-CertificatePassword <SecureString>]
   [-SecondaryCertificateFile <String>]
   [-SecondaryCertificatePassword <SecureString>]
   [-KeyVaultResouceGroupName <String>]
   [-KeyVaultName <String>]
   [-VmPassword <SecureString>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzureRmServiceFabricCluster 命令會使用您提供的憑證,或系統產生的自我簽署憑證來設定新的 Service Fabric 叢集。 使用的範本可以是預設範本或您提供的自訂範本。 您可以選擇指定資料夾以匯出自我簽署憑證,或稍後從金鑰保存庫擷取憑證。 如果您要指定自定義範本和參數檔案,則不需要在參數檔案中提供憑證資訊,系統會填入這些參數。 下列四個選項詳述。 向下捲動以取得每個參數的說明。

範例

範例 1:只指定叢集大小、憑證主體名稱和要部署叢集的 OS。

$pass="Password#1234" | ConvertTo-SecureString -AsPlainText -Force
$RGname="test01"
$clusterloc="SouthCentralUS"
$subname="{0}.{1}.cloudapp.azure.com" -f $RGname, $clusterloc
$pfxfolder="c:\certs"

Write-Output "Create cluster in '$clusterloc' with cert subject name '$subname' and cert output path '$pfxfolder'"

New-AzureRmServiceFabricCluster -ResourceGroupName $RGname -Location $clusterloc -ClusterSize 5 -VmPassword $pass -CertificateSubjectName $subname -CertificateOutputFolder $pfxfolder -CertificatePassword $pass -OS WindowsServer2016Datacenter

此命令只會指定要部署叢集的叢集大小、憑證主體名稱和OS。

範例 2:在金鑰保存庫中指定現有的憑證資源,以及部署叢集的自定義範本

$RGname="test20"
$templateParmfile="C:\service-fabric-secure-nsg-cluster-65-node-3-nodetype\azuredeploytest.parameters.json"
$templateFile="C:\azure-quickstart-templates\service-fabric-secure-nsg-cluster-65-node-3-nodetype\azuredeploy.json"
$secretId="https://test1.vault.azure.net:443/secrets/testcertificate4/56ec774dc61a462bbc645ffc9b4b225f"

New-AzureRmServiceFabricCluster -ResourceGroupName $RGname -TemplateFile $templateFile -ParameterFile $templateParmfile -SecretIdentifier $secretId

此命令會指定金鑰保存庫中的現有憑證資源,以及部署叢集的自定義範本。

範例 3:使用自定義範本建立新的叢集。 為金鑰保存庫指定不同的資源組名,並讓系統將新的憑證上傳至該保存庫

$pass="Password#1234" | ConvertTo-SecureString -AsPlainText -Force
$RGname="test20"
$keyVaultRG="test20kvrg"
$keyVault="test20kv"
$clusterloc="SouthCentralUS"
$subname="{0}.{1}.$clusterloc.cloudapp.azure.com" -f $RGName, $clusterloc
$pfxfolder="~\Documents"
$templateParmfile="C:\service-fabric-secure-nsg-cluster-65-node-3-nodetype\azuredeploytest.parameters.json"
$templateFile="C:\service-fabric-secure-nsg-cluster-65-node-3-nodetype\azuredeploy.json"

New-AzureRmServiceFabricCluster -ResourceGroupName $RGname -TemplateFile $templateFile -ParameterFile $templateParmfile -CertificateOutputFolder $pfxfolder -CertificatePassword $pass -KeyVaultResouceGroupName $keyVaultRG  -KeyVaultName $keyVault -CertificateSubjectName $subname

此命令會使用自定義範本建立新的叢集。 為金鑰保存庫指定不同的資源組名,並讓系統將新的憑證上傳至該保存庫

範例 4:自備憑證和自定義範本,並建立新的叢集

$pass="Password#1234" | ConvertTo-SecureString -AsPlainText -Force
$RGname="test20"
$keyVaultRG="test20kvrg"
$keyVault="test20kv"
$pfxsourcefile="c:\Mycertificates\my2017Prodcert.pfx"
$templateParmfile="~\Documents\GitHub\azure-quickstart-templates-parms\service-fabric-secure-nsg-cluster-65-node-3-nodetype\azuredeploytest.parameters.json"
$templateFile="~\GitHub\azure-quickstart-templates\service-fabric-secure-nsg-cluster-65-node-3-nodetype\azuredeploy.json"

New-AzureRmServiceFabricCluster -ResourceGroupName $RGname -TemplateFile $templateFile -ParameterFile $templateParmfile -CertificateFile $pfxsourcefile -CertificatePassword $pass -KeyVaultResouceGroupName $keyVaultRG -KeyVaultName $keyVault

此命令可讓您自備憑證和自定義範本,並建立新的叢集。

參數

-CertificateFile

主要叢集憑證的現有憑證檔案路徑。

類型:String
Aliases:Source
Position:Named
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-CertificateOutputFolder

要建立之新憑證檔案的資料夾。

類型:String
Aliases:Destination
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-CertificatePassword

憑證檔案的密碼。

類型:SecureString
Aliases:CertPassword
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-CertificateSubjectName

要建立之憑證的主體名稱。

類型:String
Aliases:Subject
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-ClusterSize

叢集中的節點數目。 預設值為5個節點。

類型:Int32
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
Aliases:cf
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyVaultName

Azure 金鑰保存庫名稱。 如果未指定,則會預設為資源組名。

類型:String
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-KeyVaultResouceGroupName

Azure 金鑰保存庫資源組名。 如果未指定,則會預設為資源組名。

類型:String
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

資源群組位置。

類型:String
Position:Named
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定叢集的名稱。 如果未指定,它將會與資源組名相同。

類型:String
Aliases:ClusterName
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-OS

組成叢集之 VM 的作業系統。

類型:OperatingSystem
Aliases:VmImage
接受的值:WindowsServer2012R2Datacenter, WindowsServer2016Datacenter, WindowsServer2016DatacenterwithContainers, UbuntuServer1604
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-ParameterFile

範本參數檔案的路徑。

類型:String
Position:Named
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

指定資源群組的名稱。

類型:String
Position:0
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-SecondaryCertificateFile

次要叢集憑證的現有憑證檔案路徑。

類型:String
Aliases:SecSource
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-SecondaryCertificatePassword

憑證檔案的密碼。

類型:SecureString
Aliases:SecCertPassword
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-SecretIdentifier

現有的 Azure 金鑰保存庫秘密 URL,例如:'https://mykv.vault.azure.net:443/secrets/mysecrets/55ec7c4dc61a462bbc645ffc9b4b225f。

類型:String
Position:Named
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-TemplateFile

範本檔案的路徑。

類型:String
Position:Named
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-VmPassword

Vm 的密碼。

類型:SecureString
Position:Named
預設值:None
必要:True
Accept pipeline input:True
Accept wildcard characters:False

-VmSku

Vm Sku。

類型:String
Aliases:Sku
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-VmUserName

用於登入 Vm 的用戶名稱。

類型:String
Position:Named
預設值:None
必要:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
Aliases:wi
Position:Named
預設值:None
必要:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

參數:CertificateFile (ByValue)、CertificateOutputFolder (ByValue)、CertificateSubjectName (ByValue)、KeyVaultName (ByValue)、KeyVaultResouceGroupName (ByValue)、Location (ByValue)、Name(ByValue)、ParameterFile(ByValue)、SecondaryCertificateFile (ByValue)、SecretIdentifier (ByValue)、TemplateFile(ByValue)、VmUserName (ByValue)

SecureString

參數:CertificatePassword (ByValue)、SecondaryCertificatePassword (ByValue)

Int32

參數:ClusterSize (ByValue)

OperatingSystem

輸出

PSDeploymentResult