New-DSGatewayRulesetAccessRule

Sinopsis

Crear una regla de acceso de un conjunto de reglas de puerta de enlace.

Sintaxis

__AllParameterSets

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

Descripción

Crea una regla de acceso de un conjunto de reglas de puerta de enlace. Según el tipo especificado, se aplica una expresión regular correspondiente para validar el valor de entrada. Use el objeto resultante con New-DSGatewayRuleset o Update-DSGatewayRuleset.

Este cmdlet se denominaba anteriormente New-DSVirtualGatewayAccessRule. Ese nombre sigue disponible como alias.

Ejemplos

Ejemplo 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

Crear una puerta de enlace ruleset que deniegue el acceso desde una dirección IP específica y desde el dominio 'a.com'.

Ejemplo 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

Reemplazar todas las reglas de acceso existentes de la puerta de enlace ruleset por una que deniegue la dirección IP '1.2.3.4'.

Parámetros

-Access

El efecto de la regla.

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

El tipo de la regla.

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

El valor de la regla según el tipo.

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

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Salidas

Devolutions.PowerShell.PSOutputObject.PSGatewayAccessRule

Regla de acceso del conjunto de reglas de puerta de enlace que se usa en (New, Update)-DSGatewayRuleset.

Notas

Para más información, escriba "Get-Help New-DSGatewayRulesetAccessRule -detailed". Para obtener información técnica, escriba "Get-Help New-DSGatewayRulesetAccessRule -full".