New-SIAPolicyFQDNRuleDefinition
SYNOPSIS
Defines FQDN rules for On-Prem provider rules asserted in a SIA policy.
SYNTAX
New-SIAPolicyFQDNRuleDefinition [-operator] <String> [-computernamePattern] <String> [-domain] <String>
[<CommonParameters>]
DESCRIPTION
Defines criteria based on FQDN rules specified in a SIA policy.
Target machines matching the criteria will be accessible via a policy containing the rule(s).
The object output by this function is used as input for the `fqdnRules` parameter of the `New-SIAPolicyProviderDefinition` function.
EXAMPLES
Example 1
$FQDNrules = New-SIAPolicyFQDNRuleDefinition -operator EXACTLY -computernamePattern SomeHost -domain SomeDomain.com
Creates the definition of an FQDN rule to exactly match a virtual machine named SomeHost.SomeDomain.com
The `$FQDNrules` variable in the above example is used as input for the `fqdnRules` parameter of the `New-SIAPolicyProviderDefinition` function.
Example 2
$FQDNrules = @()
$FQDNrules += New-SIAPolicyFQDNRuleDefinition -operator EXACTLY -computernamePattern SomeHost -domain SomeDomain.com
$FQDNrules += New-SIAPolicyFQDNRuleDefinition -operator WILDCARD -computernamePattern '*-DEV-*' -domain SomeDomain.com
$FQDNrules += New-SIAPolicyFQDNRuleDefinition -operator SUFFIX -computernamePattern '-Prod' -domain SomeDomain.com
$FQDNrules += New-SIAPolicyFQDNRuleDefinition -operator CONTAINS -computernamePattern SQL -domain SomeDomain.com
$FQDNrules += New-SIAPolicyFQDNRuleDefinition -operator PREFIX -computernamePattern DC1 -domain SomeDomain.com
Creates a definition of FQDN rules to match virtual machines according to the parameter values specified.
The `$FQDNrules` variable in the above example is used as input for the `fqdnRules` parameter of the `New-SIAPolicyProviderDefinition` function.
PARAMETERS
-computernamePattern
The pattern to match in relations to the operator
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-domain
The domain in which to execute the operator on the pattern
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-operator
Operator to perform on the FQDN
Type: String
Parameter Sets: (All)
Aliases:
Accepted values: EXACTLY, WILDCARD, PREFIX, SUFFIX, CONTAINS
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.