Edit

Share via

New-AzureADMSNamedLocationPolicy

Module:
AzureAD Module

Creates a new named ___location policy in Azure Active Directory.

Syntax

Default (Default) 

New-AzureADMSNamedLocationPolicy
    [-OdataType <String>]
    [-Id <String>]
    [-DisplayName <String>]
    [-IpRanges <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.IpRange]>]
    [-IsTrusted <Boolean>]
    [-CountriesAndRegions <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.CountriesAndRegion]>]
    [-IncludeUnknownCountriesAndRegions <Boolean>]
    [<CommonParameters>]

Description

This cmdlet allows an admin to create new named ___location policy in Azure Active Directory. Conditional access policies are custom rules that define an access scenario.

Note

Named Locations created by PowerShell will only display in Named locations (preview), you can't see them in them in the old view.

Examples

Example 1: Creates a new Ip named ___location policy in Azure AD.

PS C:\> $ipRanges = New-Object -TypeName Microsoft.Open.MSGraph.Model.IpRange
          PS C:\> $ipRanges.cidrAddress = "6.5.4.3/32"
          PS C:\> New-AzureADMSNamedLocationPolicy -OdataType "#microsoft.graph.ipNamedLocation" -DisplayName "IP named ___location policy" -IsTrusted $false -IpRanges $ipRanges

          OdataType               : #microsoft.graph.ipNamedLocation
          Id                      : 6b5e999b-0ba8-4186-a106-e0296c1c4358
          DisplayName             : IP named ___location policy
          CreatedDateTime         : 2019-09-26T23:12:16.0792706Z
          ModifiedDateTime        : 2019-09-27T00:12:12.5986473Z
          IsTrusted               : false
          IpRanges                : {
                                      class IpRange {
                                        CidrAddress: 6.5.4.3/32
                                      }
                                    }

This command creates a new IP named ___location policy in Azure AD.

Example 2: Creates a new country or region named ___location policy in Azure AD.

PS C:\> New-AzureADMSNamedLocationPolicy -OdataType "#microsoft.graph.countryNamedLocation" -DisplayName "Country named ___location policy" -CountriesAndRegions "IN" -IncludeUnknownCountriesAndRegions $false

          OdataType                         : #microsoft.graph.countryNamedLocation
          Id                                : 13975bae-089f-4358-8da3-cc262f29276b
          DisplayName                       : Country named ___location policy
          CreatedDateTime                   : 2019-09-26T23:12:16.0792706Z
          ModifiedDateTime                  : 2019-09-27T00:12:12.5986473Z
          CountriesAndRegions               : {IN}
          IncludeUnknownCountriesAndRegions : False

This command creates a new country or region named ___location policy in Azure AD.

Parameters

-CountriesAndRegions

Specifies the countries and regions for the named ___location policy in Azure Active Directory.

Parameter properties

Type:

List<T>[Microsoft.Open.MSGraph.Model.CountriesAndRegion]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisplayName

Specifies the display name of a named ___location policy in Azure Active Directory.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Id

{{ Fill Id Description }}

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-IncludeUnknownCountriesAndRegions

Specifies the includeUnknownCountriesAndRegions value for the named ___location policy in Azure Active Directory.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-IpRanges

Specifies the ip ranges of the named ___location policy in Azure Active Directory.

Parameter properties

Type:

List<T>[Microsoft.Open.MSGraph.Model.IpRange]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-IsTrusted

Specifies the isTrusted value for the named ___location policy in Azure Active Directory.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-OdataType

Specifies the odata type of a named ___location policy object in Azure Active Directory.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Notes

See the migration guide for New-AzureADMSNamedLocationPolicy to the Microsoft Graph PowerShell.