New-AzServiceFabricCluster

Ссылка

Модуль:: Az.ServiceFabric

Эта команда использует сертификаты, предоставляемые или созданные системой самозаверяющие сертификаты для настройки нового кластера Service Fabric. Он может использовать шаблон по умолчанию или настраиваемый шаблон, который вы предоставляете. У вас есть возможность указать папку для экспорта самозаверяющих сертификатов в хранилище ключей или их получения позже.

Синтаксис

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

Описание

Команда New-AzServiceFabricCluster использует сертификаты, предоставляемые или созданные системой самозаверяющие сертификаты для настройки нового кластера Service Fabric. Используемый шаблон может быть шаблоном по умолчанию или пользовательским шаблоном, предоставляемым вами. У вас есть возможность указать папку, чтобы экспортировать самозаверяющие сертификаты или получить их позже из хранилища ключей. Если вы указываете пользовательский шаблон и файл параметров, вам не нужно предоставлять сведения о сертификате в файле параметров, система заполняет эти параметры. Ниже описаны четыре варианта. Прокрутите вниз для объяснения каждого из параметров.

Примеры

Пример 1. Укажите только размер кластера, имя субъекта сертификата и ОС для развертывания кластера.

$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

Эта команда указывает только размер кластера, имя субъекта сертификата и ОС для развертывания кластера.

Пример 2. Указание существующего ресурса сертификата в хранилище ключей и пользовательского шаблона для развертывания кластера

$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

Эта команда указывает существующий ресурс сертификата в хранилище ключей и пользовательский шаблон для развертывания кластера.

Пример 3. Создание нового кластера с помощью пользовательского шаблона. Укажите другое имя группы ресурсов для хранилища ключей и отправьте в него новый сертификат.

$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

Эта команда создает новый кластер с помощью пользовательского шаблона. Укажите другое имя группы ресурсов для хранилища ключей и отправьте в него новый сертификат.

Пример 4. Создание собственного сертификата и пользовательского шаблона и создание нового кластера

$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

Эта команда позволит вам принести собственный сертификат и пользовательский шаблон и создать новый кластер.

Параметры

-CertificateCommonName

Общее имя сертификата

Тип:	String
Aliases:	CertCommonName
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CertificateFile

Существующий путь к файлу сертификата для первичного сертификата кластера

Тип:	String
Aliases:	Source
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-CertificateIssuerThumbprint

Отпечаток издателя сертификата, разделенный запятыми, если несколько

Тип:	String
Aliases:	CertIssuerThumbprint
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CertificateOutputFolder

Папка создаваемого файла сертификата

Тип:	String
Aliases:	Destination
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-CertificatePassword

Пароль файла сертификата

Тип:	SecureString
Aliases:	CertPassword
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-CertificateSubjectName

Имя субъекта создаваемого сертификата

Тип:	String
Aliases:	Subject
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ClusterSize

Количество узлов в кластере. Значение по умолчанию — 5 узлов

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Тип:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-KeyVaultName

Имя хранилища ключей Azure, если оно не задано, по умолчанию будет присвоено имени группы ресурсов.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-KeyVaultResourceGroupName

Имя группы ресурсов хранилища ключей Azure, если оно не указано, по умолчанию будет присвоено имя группы ресурсов.

Тип:	String
Aliases:	KeyVaultResouceGroupName
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Location

Расположение группы ресурсов

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Name

Укажите имя кластера, если оно не указано, совпадает с именем группы ресурсов.

Тип:	String
Aliases:	ClusterName
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-OS

Операционная система виртуальных машин, составляющих кластер.

Тип:	OperatingSystem
Aliases:	VmImage
Допустимые значения:	WindowsServer2012R2Datacenter, WindowsServer2016Datacenter, WindowsServer2016DatacenterwithContainers, UbuntuServer1604, UbuntuServer1804, UbuntuServer2004, WindowsServer2022
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ParameterFile

Путь к файлу параметров шаблона.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-ResourceGroupName

Укажите имя группы ресурсов.

Тип:	String
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-SecondaryCertificateFile

Существующий путь к файлу сертификата для дополнительного сертификата кластера

Тип:	String
Aliases:	SecSource
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-SecondaryCertificatePassword

Пароль файла сертификата

Тип:	SecureString
Aliases:	SecCertPassword
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-SecretIdentifier

Существующий URL-адрес секрета хранилища ключей Azure, например "https://mykv.vault.azure.net:443/secrets/mysecrets/55ec7c4dc61a462bbc645ffc9b4b225f"

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-TemplateFile

Путь к файлу шаблона.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Thumbprint

Отпечаток для сертификата корреспоинде в SecretIdentifier. Используйте это, если сертификат не управляется, так как хранилище ключей хранится только в качестве секрета, и командлет не может повторно выполнить отпечаток.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-VmPassword

Пароль виртуальной машины.

Тип:	SecureString
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-VmSku

Sku виртуальной машины

Тип:	String
Aliases:	Sku
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-VmUserName

Имя пользователя для ведения журнала на виртуальную машину

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

String

SecureString

Int32

OperatingSystem

Выходные данные

PSDeploymentResult

Поделиться через