New-AzNetworkManagerSecurityAdminRule
Creates a security admin rule.
Syntax
Custom (Default)
New-AzNetworkManagerSecurityAdminRule
-Name <String>
-RuleCollectionName <String>
-SecurityAdminConfigurationName <String>
-NetworkManagerName <String>
-ResourceGroupName <String>
-Protocol <String>
-Direction <String>
-Access <String>
-Priority <Int32>
[-Description <String>]
[-SourceAddressPrefix <PSNetworkManagerAddressPrefixItem[]>]
[-DestinationAddressPrefix <PSNetworkManagerAddressPrefixItem[]>]
[-SourcePortRange <String[]>]
[-DestinationPortRange <String[]>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
New-AzNetworkManagerSecurityAdminRule
-Name <String>
-RuleCollectionName <String>
-SecurityAdminConfigurationName <String>
-NetworkManagerName <String>
-ResourceGroupName <String>
-Flag <String>
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The New-AzNetworkManagerSecurityAdminRule cmdlet creates a security admin rule.
Examples
Example 1: Create Custom Security Admin Rule
$sourceAddressPrefix = New-AzNetworkManagerAddressPrefixItem -AddressPrefix "Internet" -AddressPrefixType "ServiceTag"
$destinationAddressPrefix = New-AzNetworkManagerAddressPrefixItem -AddressPrefix "10.0.0.1" -AddressPrefixType "IPPrefix"
$sourcePortList = @("100")
$destinationPortList = @("99")
New-AzNetworkManagerSecurityAdminRule -ResourceGroupName "psResourceGroup" -NetworkManagerName "psNetworkManager" -ConfigName "psSecurityAdminConfig" -RuleCollectionName "psRuleCollection" -Name "psRule" -Description "TestDescription" -Protocol "TCP" -Direction "Inbound" -Access "Allow" -Priority 100 -SourcePortRange $sourcePortList -DestinationPortRange $destinationPortList -SourceAddressPrefix $sourceAddressPrefix -DestinationAddressPrefix $destinationAddressPrefix
Protocol : Tcp
Direction : Inbound
Sources : {Microsoft.Azure.Commands.Network.Models.NetworkManager.PSNetworkManagerAddressPrefixItem}
Destinations : {Microsoft.Azure.Commands.Network.Models.NetworkManager.PSNetworkManagerAddressPrefixItem}
SourcePortRanges : {100}
DestinationPortRanges : {99}
Access : Allow
Priority : 100
SourcesText : [
{
"AddressPrefix": "Internet",
"AddressPrefixType": "ServiceTag"
}
]
DestinationsText : [
{
"AddressPrefix": "10.0.0.1",
"AddressPrefixType": "IPPrefix"
}
]
SourcePortRangesText : [
"100"
]
DestinationPortRangesText : [
"99"
]
DisplayName :
Description : TestDescription
Type : Microsoft.Network/networkManagers/securityAdminConfigurations/ruleCollections/rules
ProvisioningState : Succeeded
SystemData : Microsoft.Azure.Commands.Network.Models.NetworkManager.PSSystemData
SystemDataText : {
"CreatedBy": "jaredgorthy@microsoft.com",
"CreatedByType": "User",
"CreatedAt": "2022-08-08T00:39:56.4512419Z",
"LastModifiedBy": "jaredgorthy@microsoft.com",
"LastModifiedByType": "User",
"LastModifiedAt": "2022-08-08T00:39:56.4512419Z"
}
Name : psRule
Etag :
Id : /subscriptions/f0dc2b34-dfad-40e4-83e0-2309fed8d00b/resourceGroups/psResourceGroup/providers/Microsoft.Network/networkManagers/psNetworkManager/securityAdminConfigurations/psSecurityAdminConfig/ruleCollections/psRuleCollection/rules/psRule
Creates a security admin rule.
Parameters
-Access
Access of Rule.
Parameter properties
Type: String
Default value: None Accepted values: Allow, Deny, AlwaysAllow Supports wildcards: False DontShow: False
Parameter sets
Custom
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-AsJob
Run cmdlet in the background
Parameter properties
Type: SwitchParameter
Default value: None Supports wildcards: False DontShow: False
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
Type: SwitchParameter
Default value: None Supports wildcards: False DontShow: False Aliases: cf
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-DefaultProfile
The credentials, account, tenant, and subscription used for communication with Azure.
Parameter properties
Type: IAzureContextContainer
Default value: None Supports wildcards: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-Description
Description.
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
Custom
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-DestinationAddressPrefix
Destination Address Prefixes.
Parameter properties
Parameter sets
Custom
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-DestinationPortRange
Destination Port Ranges.
Parameter properties
Type: String [ ]
Default value: None Supports wildcards: False DontShow: False
Parameter sets
Custom
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-Direction
Direction of Rule.
Parameter properties
Type: String
Default value: None Accepted values: Inbound, Outbound Supports wildcards: False DontShow: False
Parameter sets
Custom
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-Flag
Default Flag Type.
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
Default
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-Force
Do not ask for confirmation if you want to overwrite a resource
Parameter properties
Type: SwitchParameter
Default value: None Supports wildcards: False DontShow: False
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-Name
The resource name.
Parameter properties
Type: String
Default value: None Supports wildcards: True DontShow: False Aliases: ResourceName
Parameter sets
(All)
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-NetworkManagerName
The network manager name.
Parameter properties
Type: String
Default value: None Supports wildcards: True DontShow: False
Parameter sets
(All)
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-Priority
Priority of Rule.
Parameter properties
Type: Int32
Default value: None Supports wildcards: False DontShow: False
Parameter sets
Custom
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-Protocol
Protocol of Rule.
Parameter properties
Type: String
Default value: None Accepted values: Tcp, Udp, Icmp, Esp, Any, Ah Supports wildcards: False DontShow: False
Parameter sets
Custom
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-ResourceGroupName
The resource group name.
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
(All)
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-RuleCollectionName
The network manager security admin rule collection name.
Parameter properties
Type: String
Default value: None Supports wildcards: True DontShow: False
Parameter sets
(All)
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-SecurityAdminConfigurationName
The network manager security admin configuration name.
Parameter properties
Type: String
Default value: None Supports wildcards: True DontShow: False Aliases: ConfigName
Parameter sets
(All)
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-SourceAddressPrefix
Source Address Prefixes.
Parameter properties
Parameter sets
Custom
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-SourcePortRange
Source Port Ranges.
Parameter properties
Type: String [ ]
Default value: None Supports wildcards: False DontShow: False
Parameter sets
Custom
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: True Value from remaining arguments: False
-WhatIf
Shows what would happen if the cmdlet runs.
The cmdlet is not run.
Parameter properties
Type: SwitchParameter
Default value: None Supports wildcards: False DontShow: False Aliases: wi
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters .
Outputs