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.

Syntax

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

$password = "Password#1234" | ConvertTo-SecureString -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 = "Password#1234" | ConvertTo-SecureString -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 = "Password#1234" | ConvertTo-SecureString -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
Aliases:	CertCommonName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateFile

Het bestaande pad naar het certificaatbestand voor het primaire clustercertificaat

Type:	String
Aliases:	Source
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CertificateIssuerThumbprint

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

Type:	String
Aliases:	CertIssuerThumbprint
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateOutputFolder

De map van het nieuwe certificaatbestand dat moet worden gemaakt

Type:	String
Aliases:	Destination
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-CertificatePassword

Het wachtwoord van het certificaatbestand

Type:	SecureString
Aliases:	CertPassword
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-CertificateSubjectName

De onderwerpnaam van het certificaat dat moet worden gemaakt

Type:	String
Aliases:	Subject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ClusterSize

Het aantal knooppunten in het cluster. Standaard zijn 5 knooppunten

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-KeyVaultResourceGroupName

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

Type:	String
Aliases:	KeyVaultResouceGroupName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

De locatie van de resourcegroep

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Geef de naam van het cluster op, als dit niet hetzelfde is als de naam van de resourcegroep

Type:	String
Aliases:	ClusterName
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-OS

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

Type:	OperatingSystem
Aliases:	VmImage
Accepted values:	WindowsServer2012R2Datacenter, WindowsServer2016Datacenter, WindowsServer2016DatacenterwithContainers, UbuntuServer1604, UbuntuServer1804, UbuntuServer2004, WindowsServer2022
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ParameterFile

Het pad naar het sjabloonparameterbestand.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

Geef de naam van de resourcegroep op.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SecondaryCertificateFile

Het bestaande pad naar het certificaatbestand voor het secundaire clustercertificaat

Type:	String
Aliases:	SecSource
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-SecondaryCertificatePassword

Het wachtwoord van het certificaatbestand

Type:	SecureString
Aliases:	SecCertPassword
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-TemplateFile

Het pad naar het sjabloonbestand.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VmPassword

Het wachtwoord van de virtuele machine.

Type:	SecureString
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VmSku

De VM-SKU

Type:	String
Aliases:	Sku
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VmUserName

De gebruikersnaam voor logboekregistratie bij vm

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Invoerwaarden

String

SecureString

Int32

OperatingSystem

Uitvoerwaarden

PSDeploymentResult