Get-AzFrontDoorCdnRule

Gets an existing delivery rule within a rule set.

Syntax

Get-AzFrontDoorCdnRule
   -ProfileName <String>
   -ResourceGroupName <String>
   -SetName <String>
   [-SubscriptionId <String[]>]
   [-DefaultProfile <PSObject>]
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]
Get-AzFrontDoorCdnRule
   -Name <String>
   -ProfileName <String>
   -ResourceGroupName <String>
   -SetName <String>
   [-SubscriptionId <String[]>]
   [-DefaultProfile <PSObject>]
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]
Get-AzFrontDoorCdnRule
   -InputObject <ICdnIdentity>
   [-DefaultProfile <PSObject>]
   [-ProgressAction <ActionPreference>]
   [<CommonParameters>]

Description

Gets an existing delivery rule within a rule set.

Examples

Example 1: list AzureFrontDoor delivery rules within the specified rule set

Get-AzFrontDoorCdnRule -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -RuleSetName ruleset001

Name      ResourceGroupName
----      -----------------
testrule1 testps-rg-da16jm
testrule2 testps-rg-da16jm
rule1     testps-rg-da16jm

list AzureFrontDoor delivery rules within the specified rule set

Example 2: Get an AzureFrontDoor delivery rule within the specified rule set

Get-AzFrontDoorCdnRule -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -RuleSetName ruleset001 -Name rule1

Name  ResourceGroupName
----  -----------------
rule1 testps-rg-da16jm

Get an AzureFrontDoor delivery rule within the specified rule set

Example 3: Get an AzureFrontDoor delivery rule within the specified rule set via identity

$conditions = @(
    New-AzFrontDoorCdnRuleClientPortConditionObject -Name ClientPort -ParameterOperator Equal -ParameterMatchValue 80,81
    New-AzFrontDoorCdnRuleIsDeviceConditionObject -Name IsDevice -ParameterMatchValue Mobile
    New-AzFrontDoorCdnRuleSslProtocolConditionObject -Name SslProtocol -ParameterMatchValue TLSv1.2
);

       
$actions = @(
    New-AzFrontDoorCdnRuleRequestHeaderActionObject -Name ModifyRequestHeader -ParameterHeaderAction Append -ParameterHeaderName a1 -ParameterValue a1
    New-AzFrontDoorCdnRuleResponseHeaderActionObject -Name ModifyResponseHeader -ParameterHeaderAction Append -ParameterHeaderName a1 -ParameterValue a1
    New-AzFrontDoorCdnRuleUrlRedirectActionObject -Name UrlRedirect -ParameterRedirectType Moved -ParameterDestinationProtocol MatchRequest
);

New-AzFrontDoorCdnRule -ResourceGroupName testps-rg-da16jm -ProfileName fdp-v542q6 -RuleSetName ruleset001 -Name rule1 -Action $actions -Condition $conditions | Get-AzFrontDoorCdnRule

Name  ResourceGroupName
----  -----------------
rule1 testps-rg-da16jm

Get an AzureFrontDoor delivery rule within the specified rule set via identity

Parameters

-DefaultProfile

The DefaultProfile parameter is not functional. Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.

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

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-Name

Name of the delivery rule which is unique within the endpoint.

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

-ProfileName

Name of the Azure Front Door Standard or Azure Front Door Premium profile which is unique within the resource group.

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

-ProgressAction

{{ Fill ProgressAction Description }}

Type:ActionPreference
Aliases:proga
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Name of the Resource group within the Azure subscription.

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

-SetName

Name of the rule set under the profile.

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

-SubscriptionId

Azure Subscription ID.

Type:String[]
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

ICdnIdentity

Outputs

IRule

Notes

ALIASES

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

INPUTOBJECT <ICdnIdentity>: Identity Parameter

  • [CustomDomainName <String>]: Name of the domain under the profile which is unique globally.
  • [EndpointName <String>]: Name of the endpoint under the profile which is unique globally.
  • [Id <String>]: Resource identity path
  • [OriginGroupName <String>]: Name of the origin group which is unique within the endpoint.
  • [OriginName <String>]: Name of the origin which is unique within the profile.
  • [ProfileName <String>]: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group.
  • [ResourceGroupName <String>]: Name of the Resource group within the Azure subscription.
  • [RouteName <String>]: Name of the routing rule.
  • [RuleName <String>]: Name of the delivery rule which is unique within the endpoint.
  • [RuleSetName <String>]: Name of the rule set under the profile which is unique globally.
  • [SecretName <String>]: Name of the Secret under the profile.
  • [SecurityPolicyName <String>]: Name of the security policy under the profile.
  • [SubscriptionId <String>]: Azure Subscription ID.