Share via

New-MgBetaDeviceManagementExchangeOnPremisePolicy

  • Reference
Module:
Microsoft.Graph.Beta.DeviceManagement.Administration

Create new navigation property to exchangeOnPremisesPolicies for deviceManagement

Syntax

New-MgBetaDeviceManagementExchangeOnPremisePolicy
   [-ResponseHeadersVariable <String>]
   [-AccessRules <IMicrosoftGraphDeviceManagementExchangeAccessRule[]>]
   [-AdditionalProperties <Hashtable>]
   [-ConditionalAccessSettings <IMicrosoftGraphOnPremisesConditionalAccessSettings>]
   [-DefaultAccessLevel <DeviceManagementExchangeAccessLevel>]
   [-Id <String>]
   [-KnownDeviceClasses <IMicrosoftGraphDeviceManagementExchangeDeviceClass[]>]
   [-NotificationContentInputFile <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-MgBetaDeviceManagementExchangeOnPremisePolicy
   -BodyParameter <IMicrosoftGraphDeviceManagementExchangeOnPremisesPolicy>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create new navigation property to exchangeOnPremisesPolicies for deviceManagement

Parameters

-AccessRules

The list of device access rules in Exchange. The access rules apply globally to the entire Exchange organization To construct, see NOTES section for ACCESSRULES properties and create a hash table.

Type:IMicrosoftGraphDeviceManagementExchangeAccessRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AdditionalProperties

Additional Parameters

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BodyParameter

Singleton entity which represents the Exchange OnPremises policy configured for a tenant. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

Type:IMicrosoftGraphDeviceManagementExchangeOnPremisesPolicy
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ConditionalAccessSettings

Singleton entity which represents the Exchange OnPremises Conditional Access Settings for a tenant. To construct, see NOTES section for CONDITIONALACCESSSETTINGS properties and create a hash table.

Type:IMicrosoftGraphOnPremisesConditionalAccessSettings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultAccessLevel

Access Level in Exchange.

Type:DeviceManagementExchangeAccessLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Headers

Optional headers that will be added to the request.

Type:IDictionary
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

The unique identifier for an entity. Read-only.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KnownDeviceClasses

The list of device classes known to Exchange To construct, see NOTES section for KNOWNDEVICECLASSES properties and create a hash table.

Type:IMicrosoftGraphDeviceManagementExchangeDeviceClass[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NotificationContentInputFile

Input File for NotificationContent (Notification text that will be sent to users quarantined by this policy. This is UTF8 encoded byte array HTML.)

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProgressAction

{{ Fill ProgressAction Description }}

Type:ActionPreference
Aliases:proga
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResponseHeadersVariable

Optional Response Headers Variable.

Type:String
Aliases:RHV
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphDeviceManagementExchangeOnPremisesPolicy

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphDeviceManagementExchangeOnPremisesPolicy

Notes

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

ACCESSRULES <IMicrosoftGraphDeviceManagementExchangeAccessRule- []>: The list of device access rules in Exchange. The access rules apply globally to the entire Exchange organization

  • [AccessLevel <DeviceManagementExchangeAccessLevel?>]: Access Level in Exchange.
  • [DeviceClass <IMicrosoftGraphDeviceManagementExchangeDeviceClass>]: Device Class in Exchange.
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Name <String>]: Name of the device class which will be impacted by this rule.
    • [Type <DeviceManagementExchangeAccessRuleType?>]: Criteria which defines the type of device this access rule will apply to

BODYPARAMETER <IMicrosoftGraphDeviceManagementExchangeOnPremisesPolicy>: Singleton entity which represents the Exchange OnPremises policy configured for a tenant.

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [AccessRules <IMicrosoftGraphDeviceManagementExchangeAccessRule- []>]: The list of device access rules in Exchange. The access rules apply globally to the entire Exchange organization
    • [AccessLevel <DeviceManagementExchangeAccessLevel?>]: Access Level in Exchange.
    • [DeviceClass <IMicrosoftGraphDeviceManagementExchangeDeviceClass>]: Device Class in Exchange.
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [Name <String>]: Name of the device class which will be impacted by this rule.
      • [Type <DeviceManagementExchangeAccessRuleType?>]: Criteria which defines the type of device this access rule will apply to
  • [ConditionalAccessSettings <IMicrosoftGraphOnPremisesConditionalAccessSettings>]: Singleton entity which represents the Exchange OnPremises Conditional Access Settings for a tenant.
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [Enabled <Boolean?>]: Indicates if on premises conditional access is enabled for this organization
    • [ExcludedGroups <String- []>]: User groups that will be exempt by on premises conditional access. All users in these groups will be exempt from the conditional access policy.
    • [IncludedGroups <String- []>]: User groups that will be targeted by on premises conditional access. All users in these groups will be required to have mobile device managed and compliant for mail access.
    • [OverrideDefaultRule <Boolean?>]: Override the default access rule when allowing a device to ensure access is granted.
  • [DefaultAccessLevel <DeviceManagementExchangeAccessLevel?>]: Access Level in Exchange.
  • [KnownDeviceClasses <IMicrosoftGraphDeviceManagementExchangeDeviceClass- []>]: The list of device classes known to Exchange
  • [NotificationContent <Byte- []>]: Notification text that will be sent to users quarantined by this policy. This is UTF8 encoded byte array HTML.

CONDITIONALACCESSSETTINGS <IMicrosoftGraphOnPremisesConditionalAccessSettings>: Singleton entity which represents the Exchange OnPremises Conditional Access Settings for a tenant.

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [Enabled <Boolean?>]: Indicates if on premises conditional access is enabled for this organization
  • [ExcludedGroups <String- []>]: User groups that will be exempt by on premises conditional access. All users in these groups will be exempt from the conditional access policy.
  • [IncludedGroups <String- []>]: User groups that will be targeted by on premises conditional access. All users in these groups will be required to have mobile device managed and compliant for mail access.
  • [OverrideDefaultRule <Boolean?>]: Override the default access rule when allowing a device to ensure access is granted.

KNOWNDEVICECLASSES <IMicrosoftGraphDeviceManagementExchangeDeviceClass- []>: The list of device classes known to Exchange

  • [Name <String>]: Name of the device class which will be impacted by this rule.
  • [Type <DeviceManagementExchangeAccessRuleType?>]: Criteria which defines the type of device this access rule will apply to