New-AzServiceFabricCluster

Reference

Modul:: Az.ServiceFabric

Tento příkaz používá certifikáty, které poskytujete nebo systémem generují certifikáty podepsané svým držitelem k nastavení nového clusteru Service Fabric. Může použít výchozí šablonu nebo vlastní šablonu, kterou zadáte. Máte možnost zadat složku pro export certifikátů podepsaných svým držitelem nebo jejich pozdější načtení z trezoru klíčů.

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

Příkaz New-AzServiceFabricCluster používá certifikáty, které poskytujete, nebo systémem generované certifikáty podepsané svým držitelem k nastavení nového clusteru Service Fabric. Použitá šablona může být výchozí šablona nebo vlastní šablona, kterou zadáte. Máte možnost zadat složku pro export certifikátů podepsaných svým držitelem nebo jejich pozdější načtení z trezoru klíčů. Pokud zadáváte vlastní šablonu a soubor parametrů, nemusíte v souboru parametrů zadávat informace o certifikátu, systém tyto parametry naplní. Níže jsou podrobně popsány čtyři možnosti. Posuňte se dolů, kde najdete vysvětlení jednotlivých parametrů.

Příklady

Příklad 1: Zadejte pouze velikost clusteru, název subjektu certifikátu a operační systém pro nasazení clusteru.

$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

Tento příkaz určuje pouze velikost clusteru, název subjektu certifikátu a operační systém pro nasazení clusteru.

Příklad 2: Určení existujícího prostředku certifikátu v trezoru klíčů a vlastní šablony pro nasazení clusteru

$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

Tento příkaz určuje existující prostředek certifikátu v trezoru klíčů a vlastní šablonu pro nasazení clusteru.

Příklad 3: Vytvoření nového clusteru pomocí vlastní šablony Zadejte jiný název skupiny prostředků pro trezor klíčů a nahrajte do něj nový certifikát.

$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

Tento příkaz vytvoří nový cluster pomocí vlastní šablony. Zadejte jiný název skupiny prostředků pro trezor klíčů a nahrajte do něj nový certifikát.

Příklad 4: Použití vlastního certifikátu a vlastní šablony a vytvoření nového clusteru

$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

Tento příkaz vám umožní použít vlastní certifikát a vlastní šablonu a vytvořit nový cluster.

Parametry

-CertificateCommonName

Běžný název certifikátu

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

-CertificateFile

Existující cesta k souboru certifikátu primárního clusteru

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

-CertificateIssuerThumbprint

Kryptografický otisk vystavitele certifikátu oddělený čárkami, pokud je více než jeden

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

-CertificateOutputFolder

Složka nového souboru certifikátu, který se má vytvořit

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

-CertificatePassword

Heslo souboru certifikátu

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

-CertificateSubjectName

Název subjektu certifikátu, který se má vytvořit

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

-ClusterSize

Počet uzlů v clusteru Výchozí hodnota je 5 uzlů.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyVaultName

Název trezoru klíčů Azure, pokud ho neudělíte, použije se jako výchozí název skupiny prostředků.

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

-KeyVaultResourceGroupName

Název skupiny prostředků služby Azure Key Vault, pokud ji neudělíte, použije se jako výchozí název skupiny prostředků.

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

-Location

Umístění skupiny prostředků

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

-Name

Zadejte název clusteru, pokud ho nezadáte, bude stejný jako název skupiny prostředků.

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

-OS

Operační systém virtuálních počítačů, které tvoří cluster.

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

Cesta k souboru parametrů šablony.

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

-ResourceGroupName

Zadejte název skupiny prostředků.

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

-SecondaryCertificateFile

Existující cesta k souboru certifikátu pro certifikát sekundárního clusteru

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

-SecondaryCertificatePassword

Heslo souboru certifikátu

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

-SecretIdentifier

Existující adresa URL tajného kódu trezoru klíčů Azure, například "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

Cesta k souboru šablony.

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

-Thumbprint

Kryptografický otisk pro certifikát correspoinding do SecretIdentifier. Tuto možnost použijte, pokud se certifikát nespravuje, protože trezor klíčů by měl uložený jenom certifikát jako tajný klíč a rutina nemůže kryptografický otisk znovu natěžovat.

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

-VmPassword

Heslo virtuálního počítače.

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

-VmSku

Skladová položka virtuálního počítače

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

-VmUserName

Uživatelské jméno pro přihlášení k virtuálnímu počítači

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

String

SecureString

Int32

OperatingSystem

Výstupy

PSDeploymentResult