New-AzureRmApiManagementBackendServiceFabric

Creates an object of PsApiManagementServiceFabric

Warning

The AzureRM PowerShell module has been officially deprecated as of February 29, 2024. Users are advised to migrate from AzureRM to the Az PowerShell module to ensure continued support and updates.

Although the AzureRM module may still function, it's no longer maintained or supported, placing any continued use at the user's discretion and risk. Please refer to our migration resources for guidance on transitioning to the Az module.

Syntax

New-AzureRmApiManagementBackendServiceFabric
   -ManagementEndpoint <String[]>
   -ClientCertificateThumbprint <String>
   [-MaxPartitionResolutionRetry <Int32>]
   [-ServerX509Name <Hashtable>]
   [-ServerCertificateThumbprint <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

The New-AzureRmApiManagementBackendServiceFabric cmdlet creates an object of PsApiManagementServiceFabric to be used in cmdlet New-AzureRmApiManagementBackend and Set-AzureRmApiManagementBackend.

Examples

Example 1: Create a Backend Service Fabric In-Memory Object

PS C:\>$apimContext = New-AzureRmApiManagementContext -ResourceGroupName "Api-Default-WestUS" -ServiceName "contoso"
PS C:\>$ManagementEndpoints = 'https://sfbackend-01.net:443', 'https://sfbackend-02.net:443'
PS C:\>$ServerCertificateThumbprints = '33CC47C6FCA848DC9B14A6F071C1EF7C'
PS C:\>$serviceFabric = New-AzureRmApiManagementBackendServiceFabric -ManagementEndpoint  $ManagementEndpoints -ClientCertificateThumbprint "33CC47C6FCA848DC9B14A6F071C1EF7C" -ServerX509Name @{"CN=foobar.net" = @('33CC47C6FCA848DC9B14A6F071C1EF7C'); } -ServerCertificateThumbprint $ServerCertificateThumbprints

PS C:\>$backend = New-AzureRmApiManagementBackend -Context  $apimContext -BackendId 123 -Url 'https://contoso.com/awesomeapi' -Protocol http -ServiceFabricCluster $serviceFabric -Description "service fabric backend" -PassThru

Creates a Backend Service Fabric Contract

Parameters

-ClientCertificateThumbprint

Client Certificate Thumbprint for the management endpoint. This parameter is required.

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

-DefaultProfile

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

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

-ManagementEndpoint

Service Fabric Cluster management Endpoints. This parameter is required.

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

-MaxPartitionResolutionRetry

Maximum number of retries when resolving a Service Fabric partition. This parameter is optional and default value is 5.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerCertificateThumbprint

Thumbprint of certificates cluster management service uses for tls communication.This parameter is optional.

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

-ServerX509Name

Server X509 Certificate Names Collection. This parameter is optional.

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

Inputs

String

Outputs

PsApiManagementServiceFabric