次の方法で共有


New-AzServiceFabricCluster

このコマンドでは、指定した証明書またはシステムによって生成された自己署名証明書を使用して、新しい Service Fabric クラスターを設定します。 指定した既定のテンプレートまたはカスタム テンプレートを使用できます。 自己署名証明書をエクスポートするフォルダーを指定するか、後でキー コンテナーからフェッチするかを指定できます。

構文

ByDefaultArmTemplate (既定)

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

説明

New-AzServiceFabricCluster コマンドは、指定した証明書またはシステムによって生成された自己署名証明書を使用して、新しい Service Fabric クラスターを設定します。 使用するテンプレートは、既定のテンプレートまたは指定したカスタム テンプレートです。 自己署名証明書をエクスポートするフォルダーを指定するか、後でキー コンテナーからフェッチするかを選択できます。 カスタム テンプレートとパラメーター ファイルを指定する場合は、パラメーター ファイルに証明書情報を指定する必要はありません。これらのパラメーターはシステムによって設定されます。 次の 4 つのオプションについて詳しく説明します。 下にスクロールして、各パラメーターの説明を表示します。

例 1: クラスターのサイズ、証明書のサブジェクト名、およびクラスターをデプロイする OS のみを指定する

$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

このコマンドは、クラスターのサイズ、証明書のサブジェクト名、およびクラスターをデプロイする OS のみを指定します。

例 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
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:CertCommonName

パラメーター セット

ByExistingKeyVault
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByExistingPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-CertificateFile

プライマリ クラスター証明書の既存の証明書ファイル パス

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:情報源

パラメーター セット

ByExistingPfxAndVaultName
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-CertificateIssuerThumbprint

証明書発行者の拇印 (複数の場合はコンマで区切る)

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:CertIssuerThumbprint

パラメーター セット

ByExistingKeyVault
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByExistingPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-CertificateOutputFolder

作成する新しい証明書ファイルのフォルダー

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:行き先

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByNewPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-CertificatePassword

証明書ファイルのパスワード

パラメーターのプロパティ

型:SecureString
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:CertPassword

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByNewPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByExistingPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-CertificateSubjectName

作成する証明書のサブジェクト名

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:サブジェクト

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByNewPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ClusterSize

クラスター内のノードの数。 既定値は 5 ノード

パラメーターのプロパティ

型:Int32
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-KeyVaultName

Azure キー コンテナー名 (指定されていない場合) は、リソース グループ名に既定で設定されます

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByNewPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByExistingPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-KeyVaultResourceGroupName

Azure Key Vault のリソース グループ名 (指定されていない場合) はリソース グループ名に既定で設定されます

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:KeyVaultResourceGroupName

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByNewPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByExistingPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Location

リソース グループの場所

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

指定しない場合は、リソース グループ名と同じクラスターの名前を指定します

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:クラスター名

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OS

クラスターを構成する VM のオペレーティング システム。

パラメーターのプロパティ

型:OperatingSystem
規定値:None
指定可能な値:WindowsServer2012R2Datacenter, WindowsServer2016Datacenter, WindowsServer2016DatacenterwithContainers, UbuntuServer1604, UbuntuServer1804, UbuntuServer2004, WindowsServer2022
ワイルドカードのサポート:False
DontShow:False
Aliases:VmImage

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ParameterFile

テンプレート パラメーター ファイルへのパス。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByExistingKeyVault
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByNewPfxAndVaultName
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByExistingPfxAndVaultName
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResourceGroupName

リソース グループの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-SecondaryCertificateFile

セカンダリ クラスター証明書の既存の証明書ファイル パス

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:SecSource

パラメーター セット

ByExistingPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SecondaryCertificatePassword

証明書ファイルのパスワード

パラメーターのプロパティ

型:SecureString
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:SecCertPassword

パラメーター セット

ByExistingPfxAndVaultName
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SecretIdentifier

既存の Azure Key Vault シークレット URL (例: "https://mykv.vault.azure.net:443/secrets/mysecrets/55ec7c4dc61a462bbc645ffc9b4b225f"

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByExistingKeyVault
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TemplateFile

テンプレート ファイルへのパス。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByExistingKeyVault
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByNewPfxAndVaultName
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False
ByExistingPfxAndVaultName
配置:Named
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Thumbprint

SecretIdentifier に対応する証明書の拇印。 これは、証明書がキー コンテナーにシークレットとしてのみ格納され、コマンドレットが拇印を取得できないため、証明書が管理されていない場合に使用します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByExistingKeyVault
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-VmPassword

Vm のパスワード。

パラメーターのプロパティ

型:SecureString
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-VmSku

The Vm Sku

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Sku

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-VmUserName

Vm へのログ記録のユーザー名

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ByDefaultArmTemplate
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

String

SecureString

Int32

OperatingSystem

出力

PSDeploymentResult