New-DSGatewayRulesetAccessRule

Übersicht

Eine Zugriffsregel für einen Gateway-Regelsatz erstellen.

Syntax

__AllParameterSets

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

Beschreibung

Erstellt eine Zugriffsregel für einen Gateway-Regelsatz. Je nach angegebenem Typ wird ein entsprechender regulärer Ausdruck angewendet, um den Eingabewert zu überprüfen. Verwenden Sie das resultierende Objekt mit New-DSGatewayRuleset oder Update-DSGatewayRuleset.

Dieses Cmdlet hieß zuvor New-DSVirtualGatewayAccessRule. Dieser Name ist weiterhin als Alias verfügbar.

Beispiele

Beispiel 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

Erstellt einen Gateway-Regelsatz, der den Zugriff von einer bestimmten IP-Adresse und der Domäne 'a.com' verweigert.

Beispiel 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

Ersetzt alle vorhandenen Zugriffsregeln des Gateway-Regelsatzes durch eine Regel, die die IP-Adresse '1.2.3.4' verweigert.

Parameter

-Access

Die Auswirkung der Regel.

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

Der Typ der Regel.

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

Der Wert der Regel basierend auf dem Typ.

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

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Ausgaben

Devolutions.PowerShell.PSOutputObject.PSGatewayAccessRule

Zugriffsregel für einen Gateway-Regelsatz zur Verwendung in (New, Update)-DSGatewayRuleset.

Hinweise

Weitere Informationen erhalten Sie mit "Get-Help New-DSGatewayRulesetAccessRule -detailed". Technische Informationen erhalten Sie mit "Get-Help New-DSGatewayRulesetAccessRule -full".