Dela via


New-AzureRmServiceFabricCluster

Det här kommandot använder certifikat som du anger eller systemgenererade självsignerade certifikat för att konfigurera ett nytt Service Fabric-kluster. Den kan använda en standardmall eller en anpassad mall som du anger. Du kan välja att ange en mapp för att exportera självsignerade certifikat till eller hämta dem senare från nyckelvalvet.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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

Kommandot New-AzureRmServiceFabricCluster använder certifikat som du tillhandahåller eller systemgenererade självsignerade certifikat för att konfigurera ett nytt Service Fabric-kluster. Mallen som används kan vara en standardmall eller en anpassad mall som du anger. Du kan välja att ange en mapp för att exportera självsignerade certifikat eller hämta dem senare från nyckelvalvet. Om du anger en anpassad mall och parameterfil behöver du inte ange certifikatinformationen i parameterfilen. Systemet fyller i dessa parametrar. De fyra alternativen beskrivs nedan. Rulla nedåt för förklaringar av var och en av parametrarna.

Exempel

Exempel 1: Ange endast klusterstorleken, certifikatets ämnesnamn och operativsystemet för att distribuera ett kluster.

$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

Det här kommandot anger endast klusterstorleken, certifikatets ämnesnamn och operativsystemet för att distribuera ett kluster.

Exempel 2: Ange en befintlig certifikatresurs i ett nyckelvalv och en anpassad mall för att distribuera ett kluster

$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

Det här kommandot anger en befintlig certifikatresurs i ett nyckelvalv och en anpassad mall för att distribuera ett kluster.

Exempel 3: Skapa ett nytt kluster med en anpassad mall. Ange ett annat resursgruppsnamn för nyckelvalvet och låt systemet ladda upp ett nytt certifikat till det

$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

Det här kommandot skapar ett nytt kluster med hjälp av en anpassad mall. Ange ett annat resursgruppsnamn för nyckelvalvet och låt systemet ladda upp ett nytt certifikat till det

Exempel 4: Ta med ditt eget certifikat och en anpassad mall och skapa ett nytt kluster

$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

Med det här kommandot kan du ta med ditt eget certifikat och en anpassad mall och skapa ett nytt kluster.

Parametrar

-CertificateFile

Den befintliga sökvägen till certifikatfilen för det primära klustercertifikatet.

Typ:String
Aliases:Source
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-CertificateOutputFolder

Mappen för den nya certifikatfilen som ska skapas.

Typ:String
Aliases:Destination
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-CertificatePassword

Lösenordet för certifikatfilen.

Typ:SecureString
Aliases:CertPassword
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-CertificateSubjectName

Certifikatets ämnesnamn som ska skapas.

Typ:String
Aliases:Subject
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-ClusterSize

Antalet noder i klustret. Standardvärdet är 5 noder.

Typ:Int32
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Aliases:cf
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyVaultName

Namn på Azure Key Vault. Om det inte anges anges det som standard till resursgruppens namn.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-KeyVaultResouceGroupName

Resursgruppsnamn för Azure Key Vault. Om det inte anges anges som standard namnet på resursgruppen.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Platsen för resursgruppen.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Ange namnet på klustret. Om det inte anges är det samma som resursgruppens namn.

Typ:String
Aliases:ClusterName
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-OS

Operativsystemet för de virtuella datorer som utgör klustret.

Typ:OperatingSystem
Aliases:VmImage
accepterade värden:WindowsServer2012R2Datacenter, WindowsServer2016Datacenter, WindowsServer2016DatacenterwithContainers, UbuntuServer1604
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-ParameterFile

Sökvägen till mallparameterfilen.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Ange namnet på resursgruppen.

Typ:String
Position:0
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-SecondaryCertificateFile

Den befintliga certifikatfilsökvägen för det sekundära klustercertifikatet.

Typ:String
Aliases:SecSource
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-SecondaryCertificatePassword

Lösenordet för certifikatfilen.

Typ:SecureString
Aliases:SecCertPassword
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-SecretIdentifier

Den befintliga hemlighets-URL:en för Azure Key Vault, till exempel: 'https://mykv.vault.azure.net:443/secrets/mysecrets/55ec7c4dc61a462bbc645ffc9b4b225f'.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-TemplateFile

Sökvägen till mallfilen.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-VmPassword

Lösenordet för den virtuella datorn.

Typ:SecureString
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-VmSku

Vm-SKU:n.

Typ:String
Aliases:Sku
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-VmUserName

Användarnamnet för loggning till virtuell dator.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Aliases:wi
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

Parametrar: CertificateFile (ByValue), CertificateOutputFolder (ByValue), CertificateSubjectName (ByValue), KeyVaultName (ByValue), KeyVaultResouceGroupName (ByValue), Location (ByValue)e), Name (ByValue), ParameterFile (ByValue), SecondaryCertificateFile (ByValue), SecretIdentifier (ByValue), TemplateFile (ByValue), VmUserName (ByValue)

SecureString

Parametrar: CertificatePassword (ByValue), SecondaryCertificatePassword (ByValue)

Int32

Parametrar: ClusterSize (ByValue)

OperatingSystem

Utdata

PSDeploymentResult