New-AzServiceFabricCluster

Modulo:
Az.ServiceFabric Module

Questo comando usa i certificati forniti o generati dal sistema per configurare un nuovo cluster di Service Fabric. Può usare un modello predefinito o un modello personalizzato fornito. È possibile specificare una cartella per esportare i certificati autofirmati o recuperarli in un secondo momento dall'insieme di credenziali delle chiavi.

Sintassi

ByDefaultArmTemplate (Impostazione predefinita) 

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

Descrizione

Il comando New-AzServiceFabricCluster usa i certificati forniti o generati dal sistema per configurare un nuovo cluster di Service Fabric. Il modello usato può essere un modello predefinito o un modello personalizzato fornito. È possibile specificare una cartella per esportare i certificati autofirmati o recuperarli in un secondo momento dall'insieme di credenziali delle chiavi. Se si specifica un modello personalizzato e un file di parametri, non è necessario fornire le informazioni sul certificato nel file dei parametri, il sistema popola questi parametri. Le quattro opzioni sono descritte in dettaglio di seguito. Scorrere verso il basso per le spiegazioni di ognuno dei parametri.

Esempio

Esempio 1: specificare solo le dimensioni del cluster, il nome soggetto del certificato e il sistema operativo per distribuire un cluster

$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

Questo comando specifica solo le dimensioni del cluster, il nome soggetto del certificato e il sistema operativo per distribuire un cluster.

Esempio 2: Specificare una risorsa certificato esistente in un insieme di credenziali delle chiavi e un modello personalizzato per distribuire un 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

Questo comando specifica una risorsa Certificato esistente in un insieme di credenziali delle chiavi e un modello personalizzato per distribuire un cluster.

Esempio 3: Creare un nuovo cluster usando un modello personalizzato. Specificare un nome di gruppo di risorse diverso per l'insieme di credenziali delle chiavi e caricare un nuovo certificato nel sistema

$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

Questo comando crea un nuovo cluster usando un modello personalizzato. Specificare un nome di gruppo di risorse diverso per l'insieme di credenziali delle chiavi e caricare un nuovo certificato nel sistema

Esempio 4: Usare un certificato personalizzato e un modello personalizzato e creare un nuovo cluster

$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

Questo comando consentirà di usare il proprio certificato e il modello personalizzato e di creare un nuovo cluster.

Parametri

-CertificateCommonName

Nome comune del certificato

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:CertCommonName

Set di parametri

ByExistingKeyVault
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByExistingPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CertificateFile

Percorso del file di certificato esistente per il certificato del cluster primario

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Source

Set di parametri

ByExistingPfxAndVaultName
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CertificateIssuerThumbprint

Identificazione personale dell'autorità di certificazione, separata da virgole se più di una

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:CertIssuerThumbprint

Set di parametri

ByExistingKeyVault
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByExistingPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CertificateOutputFolder

Cartella del nuovo file di certificato da creare

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Destination

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByNewPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CertificatePassword

Password del file di certificato

Proprietà dei parametri

Tipo:SecureString
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:CertPassword

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByNewPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByExistingPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CertificateSubjectName

Nome soggetto del certificato da creare

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Oggetto

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByNewPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ClusterSize

Numero di nodi nel cluster. Il valore predefinito è 5 nodi

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-KeyVaultName

Azure nome dell'insieme di credenziali delle chiavi, se non viene assegnato per impostazione predefinita al nome del gruppo di risorse

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByNewPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByExistingPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-KeyVaultResourceGroupName

Azure nome del gruppo di risorse dell'insieme di credenziali delle chiavi, se non specificato, verrà impostato come nome del gruppo di risorse

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:KeyVaultResourceGroupName

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByNewPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByExistingPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Location

Posizione del gruppo di risorse

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specificare il nome del cluster, se non specificato sarà uguale al nome del gruppo di risorse

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Nome del Cluster

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OS

Sistema operativo delle macchine virtuali che costituiscono il cluster.

Proprietà dei parametri

Tipo:OperatingSystem
Valore predefinito:None
Valori accettati:WindowsServer2012R2Datacenter, WindowsServer2016Datacenter, WindowsServer2016DatacenterwithContainers, UbuntuServer1604, UbuntuServer1804, UbuntuServer2004, WindowsServer2022, WindowsServer2019Datacenter, WindowsServer2019DatacenterGen2, WindowsServer2022Standard, WindowsServer2022Core, WindowsServer2022Gen2, WindowsServer2022Hotpatch, WindowsServer2025, WindowsServer2025AzureEdition, WindowsServer2025AzureEditionCore, WindowsServer2025Gen2, UbuntuServer2204, UbuntuServer2404
Supporta i caratteri jolly:False
DontShow:False
Alias:VmImage

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ParameterFile

Percorso del file di parametri del modello.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByExistingKeyVault
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByNewPfxAndVaultName
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByExistingPfxAndVaultName
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ResourceGroupName

Specificare il nome del gruppo di risorse.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-SecondaryCertificateFile

Percorso del file di certificato esistente per il certificato del cluster secondario

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:SecSource

Set di parametri

ByExistingPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SecondaryCertificatePassword

Password del file di certificato

Proprietà dei parametri

Tipo:SecureString
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:SecCertPassword

Set di parametri

ByExistingPfxAndVaultName
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SecretIdentifier

URL del segreto dell'insieme di credenziali delle chiavi Azure esistente, ad esempio 'https://mykv.vault.azure.net:443/secrets/mysecrets/55ec7c4dc61a462bbc645ffc9b4b225f'

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByExistingKeyVault
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TemplateFile

Percorso del file modello.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByExistingKeyVault
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByNewPfxAndVaultName
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
ByExistingPfxAndVaultName
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Thumbprint

Identificazione personale per il certificato corrispondente a SecretIdentifier. Usare questa opzione se il certificato non è gestito perché l'insieme di credenziali delle chiavi contiene solo il certificato archiviato come segreto e il cmdlet non è in grado di recuperare l'identificazione personale.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByExistingKeyVault
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-VmPassword

Password della macchina virtuale.

Proprietà dei parametri

Tipo:SecureString
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-VmSku

Sku della macchina virtuale

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Sku

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-VmUserName

Nome utente per la registrazione alla macchina virtuale

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByDefaultArmTemplate
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

SecureString

Int32

OperatingSystem

Output

PSDeploymentResult