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.
$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 .
Salidas