New-AzServiceFabricCluster

Referentie

Module:: Az.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.

Syntaxis

New-AzServiceFabricCluster
   [-ResourceGroupName] <String>
   [-CertificateOutputFolder <String>]
   [-CertificatePassword <SecureString>]
   [-KeyVaultResourceGroupName <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-AzServiceFabricCluster
   [-ResourceGroupName] <String>
   -TemplateFile <String>
   -ParameterFile <String>
   [-CertificateCommonName <String>]
   [-CertificateIssuerThumbprint <String>]
   [-VmPassword <SecureString>]
   -SecretIdentifier <String>
   [-Thumbprint <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzServiceFabricCluster
   [-ResourceGroupName] <String>
   -TemplateFile <String>
   -ParameterFile <String>
   [-CertificateOutputFolder <String>]
   [-CertificatePassword <SecureString>]
   [-KeyVaultResourceGroupName <String>]
   [-KeyVaultName <String>]
   [-CertificateSubjectName <String>]
   [-VmPassword <SecureString>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzServiceFabricCluster
   [-ResourceGroupName] <String>
   -TemplateFile <String>
   -ParameterFile <String>
   -CertificateFile <String>
   [-CertificatePassword <SecureString>]
   [-SecondaryCertificateFile <String>]
   [-SecondaryCertificatePassword <SecureString>]
   [-KeyVaultResourceGroupName <String>]
   [-KeyVaultName <String>]
   [-CertificateCommonName <String>]
   [-CertificateIssuerThumbprint <String>]
   [-VmPassword <SecureString>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De opdracht New-AzServiceFabricCluster maakt gebruik van certificaten die u opgeeft of door het systeem gegenereerde zelfondertekende certificaten voor het instellen van een nieuw Service Fabric-cluster. 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

$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
$resourceGroupName = "quickstart-sf-group"
$azureRegion = "southcentralus"
$clusterDnsName = "{0}.{1}.cloudapp.azure.com" -f $resourceGroupName, $azureRegion
$localCertificateFolder = "c:\certs"

Write-Output "Create cluster in '$azureRegion' with cert subject name '$clusterDnsName' and cert output path '$localCertificateFolder'"

New-AzServiceFabricCluster -ResourceGroupName $resourceGroupName -Location $azureRegion -ClusterSize 5 -VmPassword $password -CertificateSubjectName $clusterDnsName -CertificateOutputFolder $localCertificateFolder -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

$resourceGroupName = "test20"
$templateParameterFile = "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-AzServiceFabricCluster -ResourceGroupName $resourceGroupName -TemplateFile $templateFile -ParameterFile $templateParameterFile -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

$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
$resourceGroupName = "quickstart-sf-group"
$keyVaultResourceGroupName = " quickstart-kv-group"
$keyVaultName = "quickstart-kv"
$azureRegion = "southcentralus"
$clusterDnsName = "{0}.{1}.cloudapp.azure.com" -F $resourceGroupName, $azureRegion
$localCertificateFolder = "~\Documents"
$templateParameterFile = "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-AzServiceFabricCluster -ResourceGroupName $resourceGroupName -TemplateFile $templateFile -ParameterFile $templateParameterFile -CertificateOutputFolder $localCertificateFolder -CertificatePassword $password -KeyVaultResourceGroupName $keyVaultResourceGroupName  -KeyVaultName $keyVaultName -CertificateSubjectName $clusterDnsName

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

$password = ConvertTo-SecureString -String "****" -AsPlainText -Force
$resourceGroupName = "test20"
$keyVaultResourceGroupName = "test20kvrg"
$keyVaultName = "test20kv"
$localCertificateFile = "c:\Mycertificates\my2017Prodcert.pfx"
$templateParameterFile = "~\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-AzServiceFabricCluster -ResourceGroupName $resourceGroupName -TemplateFile $templateFile -ParameterFile $templateParameterFile -CertificateFile $localCertificateFile -CertificatePassword $password -KeyVaultResourceGroupName $keyVaultResourceGroupName -KeyVaultName $keyVaultName

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

Parameters

-CertificateCommonName

Algemene certificaatnaam

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

-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

-CertificateIssuerThumbprint

Vingerafdruk van certificaatverlener, gescheiden door komma's als meer dan één

Type:	String
Aliassen:	CertIssuerThumbprint
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
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

U wordt 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, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

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

-KeyVaultName

Azure Key Vault-naam, als deze niet wordt 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

-KeyVaultResourceGroupName

Azure Key Vault-resourcegroepnaam, als deze niet wordt opgegeven, wordt deze standaard ingesteld op de naam van de resourcegroep

Type:	String
Aliassen:	KeyVaultResouceGroupName
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 dit niet hetzelfde is 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, UbuntuServer1804, UbuntuServer2004, WindowsServer2022
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

-Thumbprint

De vingerafdruk voor het certificaat correleert met de SecretIdentifier. Gebruik dit als het certificaat niet wordt beheerd als de sleutelkluis alleen het certificaat heeft opgeslagen als geheim en de cmdlet de vingerafdruk niet kan herstellen.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
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

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

String

SecureString

Int32

OperatingSystem

Uitvoerwaarden

PSDeploymentResult

Delen via