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
ByDefaultArmTemplate (domyślnie)
New-AzServiceFabricCluster
[-ResourceGroupName] <String>
-Location <String>
-VmPassword <SecureString>
[-CertificateOutputFolder <String>]
[-CertificatePassword <SecureString>]
[-KeyVaultResourceGroupName <String>]
[-KeyVaultName <String>]
[-Name <String>]
[-VmUserName <String>]
[-ClusterSize <Int32>]
[-CertificateSubjectName <String>]
[-OS <OperatingSystem>]
[-VmSku <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByExistingKeyVault
New-AzServiceFabricCluster
[-ResourceGroupName] <String>
-TemplateFile <String>
-ParameterFile <String>
-SecretIdentifier <String>
[-CertificateCommonName <String>]
[-CertificateIssuerThumbprint <String>]
[-VmPassword <SecureString>]
[-Thumbprint <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByNewPfxAndVaultName
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>]
ByExistingPfxAndVaultName
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 = 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
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 = 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
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 = 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
To polecenie umożliwi przeniesienie własnego certyfikatu i szablonu niestandardowego oraz utworzenie nowego klastra.
Parametry
-CertificateCommonName
Nazwa pospolita certyfikatu
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: CertCommonName
Zestawy parametrów
ByExistingKeyVault
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByExistingPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-CertificateFile
Istniejąca ścieżka pliku certyfikatu dla certyfikatu klastra podstawowego
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: Source
Zestawy parametrów
ByExistingPfxAndVaultName
Position: Named Obowiązkowe: True Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-CertificateIssuerThumbprint
Odcisk palca wystawcy certyfikatu rozdzielony przecinkami, jeśli więcej niż jeden
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: CertIssuerThumbprint
Zestawy parametrów
ByExistingKeyVault
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByExistingPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-CertificateOutputFolder
Folder nowego pliku certyfikatu do utworzenia
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: Destynacja
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByNewPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-CertificatePassword
Hasło pliku certyfikatu
Właściwości parametru
Typ: SecureString
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: CertPassword
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByNewPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByExistingPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-CertificateSubjectName
Nazwa podmiotu certyfikatu do utworzenia
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: Temat
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByNewPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-ClusterSize
Liczba węzłów w klastrze.
Wartość domyślna to 5 węzłów
Właściwości parametru
Typ: Int32
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
Typ: SwitchParameter
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: por
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z Azure.
Właściwości parametru
Typ: IAzureContextContainer
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: AzContext, AzureRmContext, AzureCredential
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-KeyVaultName
Azure nazwa magazynu kluczy, jeśli nie zostanie podana, zostanie ona domyślnie ustawiona na nazwę grupy zasobów
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByNewPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByExistingPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-KeyVaultResourceGroupName
Azure nazwa grupy zasobów magazynu kluczy, jeśli nie zostanie podana, zostanie ona domyślnie ustawiona na nazwę grupy zasobów
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: KeyVaultResourceGroupName
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByNewPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByExistingPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-Location
Lokalizacja grupy zasobów
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: True Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-Name
Określ nazwę klastra, jeśli nie zostanie podana, będzie taka sama jak nazwa grupy zasobów
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: ClusterName
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-OS
System operacyjny maszyn wirtualnych tworzących klaster.
Właściwości parametru
Typ: OperatingSystem
Domyślna wartość: None Dopuszczalne wartości: WindowsServer2012R2Datacenter, WindowsServer2016Datacenter, WindowsServer2016DatacenterwithContainers, UbuntuServer1604, UbuntuServer1804, UbuntuServer2004, WindowsServer2022, WindowsServer2019Datacenter, WindowsServer2019DatacenterGen2, WindowsServer2022Standard, WindowsServer2022Core, WindowsServer2022Gen2, WindowsServer2022Hotpatch, WindowsServer2025, WindowsServer2025AzureEdition, WindowsServer2025AzureEditionCore, WindowsServer2025Gen2, UbuntuServer2204, UbuntuServer2404 Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: VmImage
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: True Wartość z pozostałych argumentów: False
-ParameterFile
Ścieżka do pliku parametrów szablonu.
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
ByExistingKeyVault
Position: Named Obowiązkowe: True Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByNewPfxAndVaultName
Position: Named Obowiązkowe: True Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByExistingPfxAndVaultName
Position: Named Obowiązkowe: True Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-ResourceGroupName
Określ nazwę grupy zasobów.
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
(All)
Position: 0 Obowiązkowe: True Wartość z potoku: False Wartość z potoku według nazwy właściwości: True Wartość z pozostałych argumentów: False
-SecondaryCertificateFile
Istniejąca ścieżka pliku certyfikatu dla pomocniczego certyfikatu klastra
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: SecSource
Zestawy parametrów
ByExistingPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-SecondaryCertificatePassword
Hasło pliku certyfikatu
Właściwości parametru
Typ: SecureString
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: SecCertPassword
Zestawy parametrów
ByExistingPfxAndVaultName
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-SecretIdentifier
Istniejący adres URL wpisu tajnego magazynu kluczy Azure, na przykład "https://mykv.vault.azure.net:443/secrets/mysecrets/55ec7c4dc61a462bbc645ffc9b4b225f"
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
ByExistingKeyVault
Position: Named Obowiązkowe: True Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-TemplateFile
Ścieżka do pliku szablonu.
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
ByExistingKeyVault
Position: Named Obowiązkowe: True Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByNewPfxAndVaultName
Position: Named Obowiązkowe: True Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
ByExistingPfxAndVaultName
Position: Named Obowiązkowe: True Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-Thumbprint
Odcisk palca certyfikatu odpowiadający secretIdentifier. Użyj tej opcji, jeśli certyfikat nie jest zarządzany, ponieważ magazyn kluczy będzie miał tylko certyfikat przechowywany jako wpis tajny, a polecenie cmdlet nie może pobrać odcisku palca.
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
ByExistingKeyVault
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-VmPassword
Hasło maszyny wirtualnej.
Właściwości parametru
Typ: SecureString
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: True Wartość z potoku: False Wartość z potoku według nazwy właściwości: True Wartość z pozostałych argumentów: False
-VmSku
Jednostka SKU maszyny wirtualnej
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: Sku
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: True Wartość z pozostałych argumentów: False
-VmUserName
Nazwa użytkownika rejestrowania na maszynie wirtualnej
Właściwości parametru
Typ: String
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False
Zestawy parametrów
ByDefaultArmTemplate
Position: Named Obowiązkowe: False Wartość z potoku: True Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione.
Cmdlet nie jest uruchomiony.
Właściwości parametru
Typ: SwitchParameter
Domyślna wartość: None Obsługuje symbole wieloznaczne: False DontShow: False Aliasy: Wi
Zestawy parametrów
(All)
Position: Named Obowiązkowe: False Wartość z potoku: False Wartość z potoku według nazwy właściwości: False Wartość z pozostałych argumentów: False
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters .
Dane wyjściowe
