New-DSGatewayRulesetAccessRule

Synopsis

Créer une règle d'accès d'ensemble de règles de passerelle.

Syntaxe

__AllParameterSets

New-DSGatewayRulesetAccessRule [-Access] <GatewayAccessRule> [-Type] <NetworkAccessRuleType>
 [-Value] <string> [<CommonParameters>]

Description

Crée une règle d'accès d'ensemble de règles de passerelle. Selon le type spécifié, une expression régulière correspondante est appliquée pour valider la valeur saisie. Utilisez l'objet obtenu avec New-DSGatewayRuleset ou Update-DSGatewayRuleset.

Cette applet de commande s'appelait auparavant New-DSVirtualGatewayAccessRule. Ce nom est toujours disponible comme alias.

Exemples

Exemple 1

PS C:\> $rules = @(
    New-DSGatewayRulesetAccessRule -Access Deny -Type IP -Value '1.2.3.4'
    New-DSGatewayRulesetAccessRule -Access Deny -Type DNS 'a.com'
  )
PS C:\> $gatewayId = Get-DSGateway -Name 'GatewayA' | Select-Object -ExpandProperty ID
PS C:\> New-DSGatewayRuleset -LinkedGatewayID $gatewayId -Name 'My gateway ruleset' -Description 'A little description' -Rule $rules

Créer un ensemble de règles de passerelle qui refuse l'accès à partir d'une adresse IP précise et du domaine 'a.com'.

Exemple 2

PS C:\> $gatewayId = Get-DSGateway -Name 'GatewayRulesetA' | Select-Object -ExpandProperty ID
PS C:\> $newRule = New-DSGatewayRulesetAccessRule -Access Deny -Type IP -Value '1.2.3.4'
PS C:\> Update-DSGatewayRuleset -GatewayID $gatewayId -Rule $newRule

Remplacer toutes les règles d'accès existantes de l'ensemble de règles de passerelle par une règle qui refuse l'adresse IP '1.2.3.4'.

Paramètres

-Access

L'effet de la règle.

Type: Devolutions.PowerShell.Enums.GatewayAccessRule
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Type

Le type de la règle.

Type: Devolutions.RemoteDesktopManager.NetworkAccessRuleType
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Value

La valeur de la règle selon le type.

Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 2
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d'information, voir about_CommonParameters.

Sorties

Devolutions.PowerShell.PSOutputObject.PSGatewayAccessRule

Règle d'accès d'ensemble de règles de passerelle à utiliser dans (New, Update)-DSGatewayRuleset.

Notes

Pour plus d'information, tapez "Get-Help New-DSGatewayRulesetAccessRule -detailed". Pour de l'information technique, tapez "Get-Help New-DSGatewayRulesetAccessRule -full".