New-DSVirtualGatewayAccessRule

Übersicht

Erstellen Sie eine Zugriffsregel für ein virtuelles Gateway.

Syntax

__AllParameterSets

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

Beschreibung

Erstellt eine Zugriffsregel für ein virtuelles Gateway. Abhängig vom angegebenen Typ wird ein entsprechender regulärer Ausdruck angewendet, um den Eingabewert zu validieren.

Beispiele

Beispiel 1

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

Erstellen Sie ein virtuelles Gateway, das den Zugriff von einer bestimmten IP-Adresse und der Domäne 'a.com' verweigert.

Beispiel 2

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

Ersetzen Sie alle bestehenden Zugriffsregeln des virtuellen Gateways 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

Hinweise

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