New-AzServiceFabricCluster

Este comando usa certificados que proporciona o certificados autofirmados generados por el sistema para configurar un nuevo clúster de Service Fabric. Puede usar una plantilla predeterminada o una plantilla personalizada que proporcione. Tiene la opción de especificar una carpeta para exportar los certificados autofirmados a o capturarlos más adelante desde el almacén de claves.

Sintaxis

ByDefaultArmTemplate (valor predeterminado)

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

Description

El comando New-AzServiceFabricCluster usa certificados que proporciona o certificados autofirmados generados por el sistema para configurar un nuevo clúster de Service Fabric. La plantilla usada puede ser una plantilla predeterminada o una plantilla personalizada que proporcione. Tiene la opción de especificar una carpeta para exportar los certificados autofirmados o capturarlos más adelante desde el almacén de claves. Si va a especificar una plantilla personalizada y un archivo de parámetros, no es necesario proporcionar la información del certificado en el archivo de parámetros, el sistema rellenará estos parámetros. A continuación se detallan las cuatro opciones. Desplácese hacia abajo para obtener explicaciones de cada uno de los parámetros.

Ejemplos

Ejemplo 1: especificar solo el tamaño del clúster, el nombre del firmante del certificado y el sistema operativo para implementar un clúster

$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

Este comando especifica solo el tamaño del clúster, el nombre del firmante del certificado y el sistema operativo para implementar un clúster.

Ejemplo 2: Especificación de un recurso de certificado existente en un almacén de claves y una plantilla personalizada para implementar un clúster

$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

Este comando especifica un recurso de certificado existente en un almacén de claves y una plantilla personalizada para implementar un clúster.

Ejemplo 3: Creación de un nuevo clúster mediante una plantilla personalizada. Especifique un nombre de grupo de recursos diferente para el almacén de claves y haga que el sistema cargue un nuevo certificado en él.

$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

Este comando crea un nuevo clúster mediante una plantilla personalizada. Especifique un nombre de grupo de recursos diferente para el almacén de claves y haga que el sistema cargue un nuevo certificado en él.

Ejemplo 4: Traiga su propio certificado y plantilla personalizada y cree un nuevo clúster

$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

Este comando le permitirá traer su propio certificado y plantilla personalizada y crear un nuevo clúster.

Parámetros

-CertificateCommonName

Nombre común del certificado

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:CertCommonName

Conjuntos de parámetros

ByExistingKeyVault
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByExistingPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CertificateFile

Ruta de acceso del archivo de certificado existente para el certificado de clúster principal

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Source

Conjuntos de parámetros

ByExistingPfxAndVaultName
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CertificateIssuerThumbprint

Huella digital del emisor de certificados, separadas por comas si hay más de una

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:CertIssuerThumbprint

Conjuntos de parámetros

ByExistingKeyVault
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByExistingPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CertificateOutputFolder

Carpeta del nuevo archivo de certificado que se va a crear

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Destination

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByNewPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CertificatePassword

Contraseña del archivo de certificado

Propiedades de parámetro

Tipo:SecureString
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:CertPassword

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByNewPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByExistingPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CertificateSubjectName

Nombre del firmante del certificado que se va a crear.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Asunto

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByNewPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ClusterSize

Número de nodos del clúster. El valor predeterminado son 5 nodos

Propiedades de parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-KeyVaultName

Azure nombre del almacén de claves, si no se le asigna el valor predeterminado al nombre del grupo de recursos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByNewPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByExistingPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-KeyVaultResourceGroupName

Azure nombre del grupo de recursos del almacén de claves, si no se le asigna el nombre del grupo de recursos, el valor predeterminado será el nombre del grupo de recursos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:KeyVaultResourceGroupName

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByNewPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByExistingPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Location

Ubicación del grupo de recursos

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifique el nombre del clúster, si no se le asigna, será el mismo que el nombre del grupo de recursos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Nombre del Clúster

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OS

Sistema operativo de las máquinas virtuales que componen el clúster.

Propiedades de parámetro

Tipo:OperatingSystem
Valor predeterminado:None
Valores aceptados:WindowsServer2012R2Datacenter, WindowsServer2016Datacenter, WindowsServer2016DatacenterwithContainers, UbuntuServer1604, UbuntuServer1804, UbuntuServer2004, WindowsServer2022, WindowsServer2019Datacenter, WindowsServer2019DatacenterGen2, WindowsServer2022Standard, WindowsServer2022Core, WindowsServer2022Gen2, WindowsServer2022Hotpatch, WindowsServer2025, WindowsServer2025AzureEdition, WindowsServer2025AzureEditionCore, WindowsServer2025Gen2, UbuntuServer2204, UbuntuServer2404
Admite caracteres comodín:False
DontShow:False
Alias:VmImage

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ParameterFile

Ruta de acceso al archivo de parámetros de plantilla.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByExistingKeyVault
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByNewPfxAndVaultName
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByExistingPfxAndVaultName
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceGroupName

Especifique el nombre del grupo de recursos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-SecondaryCertificateFile

Ruta de acceso del archivo de certificado existente para el certificado de clúster secundario

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:SecSource

Conjuntos de parámetros

ByExistingPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SecondaryCertificatePassword

Contraseña del archivo de certificado

Propiedades de parámetro

Tipo:SecureString
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:SecCertPassword

Conjuntos de parámetros

ByExistingPfxAndVaultName
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SecretIdentifier

La dirección URL del secreto del almacén de claves existente Azure, por ejemplo, "https://mykv.vault.azure.net:443/secrets/mysecrets/55ec7c4dc61a462bbc645ffc9b4b225f"

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByExistingKeyVault
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TemplateFile

Ruta de acceso al archivo de plantilla.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByExistingKeyVault
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByNewPfxAndVaultName
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ByExistingPfxAndVaultName
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Thumbprint

Huella digital del certificado correspondiente al SecretIdentifier. Úselo si el certificado no se administra, ya que el almacén de claves solo tendría el certificado almacenado como secreto y el cmdlet no puede recuperar la huella digital.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByExistingKeyVault
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-VmPassword

Contraseña de la máquina virtual.

Propiedades de parámetro

Tipo:SecureString
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-VmSku

SKU de máquina virtual

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:SKU

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-VmUserName

El nombre de usuario para iniciar sesión en la máquina virtual

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByDefaultArmTemplate
Posición:Named
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

SecureString

Int32

OperatingSystem

Salidas

PSDeploymentResult