Add-AzServiceFabricClientCertificate

Module:

Az.ServiceFabric

Add common name or thumbprint to the cluster for client authentication purposes.

Syntax

Add-AzServiceFabricClientCertificate
   [-Admin]
   [-ResourceGroupName] <String>
   [-Name] <String>
   -Thumbprint <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzServiceFabricClientCertificate
   [-Admin]
   [-ResourceGroupName] <String>
   [-Name] <String>
   -CommonName <String>
   -IssuerThumbprint <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzServiceFabricClientCertificate
   [-ResourceGroupName] <String>
   [-Name] <String>
   -ClientCertificateCommonName <PSClientCertificateCommonName[]>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-AzServiceFabricClientCertificate
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-AdminClientThumbprint <String[]>]
   [-ReadonlyClientThumbprint <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use Add-AzServiceFabricClientCertificate to add a common name and issuer thumbprint or certificate thumbprint to the cluster, so the client can use it for authentication.

Examples

Example 1

Add-AzServiceFabricClientCertificate -ResourceGroupName 'Group1' -Name 'Contoso01SFCluster' -Thumbprint 5F3660C715EBBDA31DB1FFDCF508302348DE8E7A -Admin

This command will add the certificate with thumbprint '5F3660C715EBBDA31DB1FFDCF508302348DE8E7A' to the cluster, so the client can use the certificate as admin to communicate with the cluster.

Example 2

Add-AzServiceFabricClientCertificate -ResourceGroupName 'Group2' -Name 'Contoso02SFCluster' -CommonName 'Contoso.com' -IssuerThumbprint 5F3660C715EBBDA31DB1FFDCF508302348DE8E7A

This command will add a read only client certificate that's common name is 'Contoso.com' and issuer thumbprint is '5F3660C715EBBDA31DB1FFDCF508302348DE8E7A' to the cluster.

Parameters

-Admin

Client authentication type

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AdminClientThumbprint

Specify client certificate thumbprint which only has admin permission

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ClientCertificateCommonName

Specify client common name , issuer thumbprint and authentication type

Type:	PSClientCertificateCommonName[]
Aliases:	CertCommonName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CommonName

Specify client certificate common name

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IssuerThumbprint

Specify thumbprint of client certificate's issuer

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Specify the name of the cluster

Type:	String
Aliases:	ClusterName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ReadonlyClientThumbprint

Specify client certificate thumbprint which only has read only permission

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

Specify the name of the resource group.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Thumbprint

Specify client certificate thumbprint

Type:	String
Aliases:	ClientCertificateThumbprint
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

SwitchParameter

String

String[]

PSClientCertificateCommonName[]

Outputs

PSCluster

Related Links

• Remove-AzServiceFabricClientCertificate