New-AzureRmServiceFabricCluster

Referentie

Module:: AzureRM.ServiceFabric

Met deze opdracht worden certificaten gebruikt die u zelfondertekende certificaten opgeeft of die door het systeem zijn gegenereerd om een nieuw Service Fabric-cluster in te stellen. U kunt een standaardsjabloon of een aangepaste sjabloon gebruiken die u opgeeft. U kunt een map opgeven om de zelfondertekende certificaten te exporteren of ze later op te halen uit de sleutelkluis.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntaxis

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

De opdracht New-AzureRmServiceFabricCluster maakt gebruik van certificaten die u opgeeft of door het systeem gegenereerde zelfondertekende certificaten om een nieuw Service Fabric-cluster in te stellen. De gebruikte sjabloon kan een standaardsjabloon of een aangepaste sjabloon zijn die u opgeeft. U kunt een map opgeven om de zelfondertekende certificaten te exporteren of ze later op te halen uit de sleutelkluis. Als u een aangepast sjabloon- en parameterbestand opgeeft, hoeft u de certificaatgegevens niet op te geven in het parameterbestand, vult het systeem deze parameters in. De vier opties worden hieronder beschreven. Schuif omlaag voor uitleg van elk van de parameters.

Voorbeelden

Voorbeeld 1: Geef alleen de clustergrootte, de onderwerpnaam van het certificaat en het besturingssysteem op om een cluster te implementeren.

$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

Met deze opdracht geeft u alleen de clustergrootte, de onderwerpnaam van het certificaat en het besturingssysteem op om een cluster te implementeren.

Voorbeeld 2: Een bestaande certificaatresource opgeven in een sleutelkluis en een aangepaste sjabloon voor het implementeren van een cluster

$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

Met deze opdracht geeft u een bestaande certificaatresource op in een sleutelkluis en een aangepaste sjabloon voor het implementeren van een cluster.

Voorbeeld 3: Een nieuw cluster maken met behulp van een aangepaste sjabloon. Geef een andere resourcegroepnaam op voor de sleutelkluis en laat het systeem een nieuw certificaat ernaar uploaden

$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

Met deze opdracht maakt u een nieuw cluster met behulp van een aangepaste sjabloon. Geef een andere resourcegroepnaam op voor de sleutelkluis en laat het systeem een nieuw certificaat ernaar uploaden

Voorbeeld 4: Uw eigen certificaat en aangepaste sjabloon gebruiken en een nieuw cluster maken

$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

Met deze opdracht kunt u uw eigen certificaat en aangepaste sjabloon gebruiken en een nieuw cluster maken.

Parameters

-CertificateFile

Het bestaande pad naar het certificaatbestand voor het primaire clustercertificaat.

Type:	String
Aliassen:	Source
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-CertificateOutputFolder

De map van het nieuwe certificaatbestand dat moet worden gemaakt.

Type:	String
Aliassen:	Destination
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-CertificatePassword

Het wachtwoord van het certificaatbestand.

Type:	SecureString
Aliassen:	CertPassword
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-CertificateSubjectName

De onderwerpnaam van het certificaat dat moet worden gemaakt.

Type:	String
Aliassen:	Subject
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ClusterSize

Het aantal knooppunten in het cluster. Standaard zijn 5 knooppunten.

Type:	Int32
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-KeyVaultName

Azure Key Vault-naam. Als dit niet is opgegeven, wordt deze standaard ingesteld op de naam van de resourcegroep.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-KeyVaultResouceGroupName

Azure Key Vault-resourcegroepnaam. Als dit niet is opgegeven, wordt deze standaard ingesteld op de naam van de resourcegroep.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Location

De locatie van de resourcegroep.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Name

Geef de naam van het cluster op. Als deze niet is opgegeven, is deze hetzelfde als de naam van de resourcegroep.

Type:	String
Aliassen:	ClusterName
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-OS

Het besturingssysteem van de VM's waaruit het cluster bestaat.

Type:	OperatingSystem
Aliassen:	VmImage
Geaccepteerde waarden:	WindowsServer2012R2Datacenter, WindowsServer2016Datacenter, WindowsServer2016DatacenterwithContainers, UbuntuServer1604
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ParameterFile

Het pad naar het sjabloonparameterbestand.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ResourceGroupName

Geef de naam van de resourcegroep op.

Type:	String
Position:	0
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SecondaryCertificateFile

Het bestaande pad naar het certificaatbestand voor het secundaire clustercertificaat.

Type:	String
Aliassen:	SecSource
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SecondaryCertificatePassword

Het wachtwoord van het certificaatbestand.

Type:	SecureString
Aliassen:	SecCertPassword
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SecretIdentifier

De bestaande geheime URL van Azure Key Vault, bijvoorbeeld: 'https://mykv.vault.azure.net:443/secrets/mysecrets/55ec7c4dc61a462bbc645ffc9b4b225f'.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-TemplateFile

Het pad naar het sjabloonbestand.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-VmPassword

Het wachtwoord van de virtuele machine.

Type:	SecureString
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-VmSku

De VM-SKU.

Type:	String
Aliassen:	Sku
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-VmUserName

De gebruikersnaam voor logboekregistratie bij vm.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

String

Parameters: 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

Parameters: CertificatePassword (ByValue), SecondaryCertificatePassword (ByValue)

Int32

Parameters: ClusterSize (ByValue)

OperatingSystem

Uitvoerwaarden

PSDeploymentResult

Delen via