New-AzServiceFabricCluster

To polecenie używa certyfikatów, które udostępniasz lub system wygenerował certyfikaty z podpisem własnym, aby skonfigurować nowy klaster usługi Service Fabric. Może on używać szablonu domyślnego lub szablonu niestandardowego, który podajesz. Istnieje możliwość określenia folderu w celu wyeksportowania certyfikatów z podpisem własnym do lub pobrania ich później z magazynu kluczy.

Składnia

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

Opis

Polecenie New-AzServiceFabricCluster używa certyfikatów podanych lub wygenerowanych przez system certyfikatów z podpisem własnym w celu skonfigurowania nowego klastra usługi Service Fabric. Używany szablon może być szablonem domyślnym lub szablonem niestandardowym, który podajesz. Istnieje możliwość określenia folderu w celu wyeksportowania certyfikatów z podpisem własnym lub późniejszego pobrania ich z magazynu kluczy. Jeśli określasz niestandardowy szablon i plik parametrów, nie musisz podawać informacji o certyfikacie w pliku parametrów, system wypełni te parametry. Poniżej przedstawiono cztery opcje. Przewiń w dół, aby uzyskać wyjaśnienia poszczególnych parametrów.

Przykłady

Przykład 1: określ tylko rozmiar klastra, nazwę podmiotu certyfikatu i system operacyjny do wdrożenia klastra

$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

To polecenie określa tylko rozmiar klastra, nazwę podmiotu certyfikatu i system operacyjny do wdrożenia klastra.

Przykład 2. Określanie istniejącego zasobu certyfikatu w magazynie kluczy i szablonu niestandardowego w celu wdrożenia klastra

$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

To polecenie określa istniejący zasób certyfikatu w magazynie kluczy i szablon niestandardowy do wdrożenia klastra.

Przykład 3. Tworzenie nowego klastra przy użyciu szablonu niestandardowego. Określ inną nazwę grupy zasobów dla magazynu kluczy i przekaż do niego nowy certyfikat przez system

$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

To polecenie tworzy nowy klaster przy użyciu szablonu niestandardowego. Określ inną nazwę grupy zasobów dla magazynu kluczy i przekaż do niego nowy certyfikat przez system

Przykład 4. Używanie własnego certyfikatu i szablonu niestandardowego oraz tworzenie nowego klastra

$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

To polecenie umożliwi przeniesienie własnego certyfikatu i szablonu niestandardowego oraz utworzenie nowego klastra.

Parametry

-CertificateCommonName

Nazwa pospolita certyfikatu

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

-CertificateFile

Istniejąca ścieżka pliku certyfikatu dla certyfikatu klastra podstawowego

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

-CertificateIssuerThumbprint

Odcisk palca wystawcy certyfikatu rozdzielony przecinkami, jeśli więcej niż jeden

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

-CertificateOutputFolder

Folder nowego pliku certyfikatu do utworzenia

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

-CertificatePassword

Hasło pliku certyfikatu

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

-CertificateSubjectName

Nazwa podmiotu certyfikatu do utworzenia

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

-ClusterSize

Liczba węzłów w klastrze. Wartość domyślna to 5 węzłów

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-KeyVaultName

Nazwa magazynu kluczy platformy Azure, jeśli nie zostanie podana, zostanie ona domyślnie ustawiona na nazwę grupy zasobów

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

-KeyVaultResourceGroupName

Nazwa grupy zasobów usługi Azure Key Vault, jeśli nie zostanie podana, zostanie ona domyślnie ustawiona na nazwę grupy zasobów

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

-Location

Lokalizacja grupy zasobów

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

-Name

Określ nazwę klastra, jeśli nie zostanie podana, będzie taka sama jak nazwa grupy zasobów

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

-OS

System operacyjny maszyn wirtualnych tworzących klaster.

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

Ścieżka do pliku parametrów szablonu.

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

-ResourceGroupName

Określ nazwę grupy zasobów.

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

-SecondaryCertificateFile

Istniejąca ścieżka pliku certyfikatu dla pomocniczego certyfikatu klastra

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

-SecondaryCertificatePassword

Hasło pliku certyfikatu

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

-SecretIdentifier

Istniejący adres URL wpisu tajnego usługi Azure Key Vault, na przykład "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

Ścieżka do pliku szablonu.

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

-Thumbprint

Odcisk palca certyfikatu korespoinding do SecretIdentifier. Użyj tej opcji, jeśli certyfikat nie jest zarządzany, ponieważ magazyn kluczy będzie miał certyfikat przechowywany tylko jako wpis tajny, a polecenie cmdlet nie może odzyskać odcisku palca.

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

-VmPassword

Hasło maszyny wirtualnej.

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

-VmSku

Jednostka SKU maszyny wirtualnej

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

-VmUserName

Nazwa użytkownika rejestrowania na maszynie wirtualnej

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

String

SecureString

Int32

OperatingSystem

Dane wyjściowe

PSDeploymentResult