Set-EntraNamedLocationPolicy
Updates a named location policy in Microsoft Entra ID by PolicyId.
Syntax
Set-EntraNamedLocationPolicy
-PolicyId <String>
[-OdataType <String>]
[-IpRanges <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.IpRange]>]
[-IncludeUnknownCountriesAndRegions <Boolean>]
[-IsTrusted <Boolean>]
[-DisplayName <String>]
[-Id <String>]
[-CountriesAndRegions <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.CountriesAndRegion]>]
[<CommonParameters>]
Description
This cmdlet allows an admin to update a named location policy in Microsoft Entra ID by PolicyId.
Conditional access policies are custom rules that define an access scenario.
Examples
Example 1: Update an IP named location policy in Microsoft Entra ID by PolicyId
Connect-Entra -Scopes 'Policy.ReadWrite.ConditionalAccess'
$policy = Get-EntraNamedLocationPolicy | Where-Object {"$_.DisplayName -eq 'IP named location policy'"}
$ipRanges = New-Object -TypeName Microsoft.Open.MSGraph.Model.IpRange
$ipRanges.cidrAddress = '6.5.4.3/32'
$params = @{
PolicyId = $policy.Id
OdataType = '#microsoft.graph.ipNamedLocation'
IsTrusted = $false
IncludeUnknownCountriesAndRegions = $false
IpRanges = $ipRanges
}
Set-EntraNamedLocationPolicy @params
This example shows how to update an IP named location policy in Microsoft Entra ID by PolicyId.
-PolicyId
parameter specifies the Id of a named location policy.-OdataType
parameter specifies the odata type of a named location policy.-DisplayName
parameter specifies the display name of a named location policy.-IsTrusted
parameter specifies the IsTrusted value for the named location policy.-IpRanges
parameter specifies List of IP address ranges in IPv4 CIDR format (e.g., 1.2.3.4/32) or any valid IPv6 format as specified in IETF RFC596.
Example 2: Update a country named location policy in Microsoft Entra ID by PolicyId
Connect-Entra -Scopes 'Policy.ReadWrite.ConditionalAccess'
$policy = Get-EntraNamedLocationPolicy | Where-Object {"$_.DisplayName -eq 'IP named location policy'"}
$params = @{
PolicyId = $policy.Id
OdataType = '#microsoft.graph.countryNamedLocation'
IncludeUnknownCountriesAndRegions = $true
}
Set-EntraNamedLocationPolicy @params
This command updates a country named location policy in Microsoft Entra ID by PolicyId.
-PolicyId
parameter specifies the Id of a named location policy.-OdataType
parameter specifies the odata type of a named location policy.-IncludeUnknownCountriesAndRegions
parameter specifies the includeUnknownCountriesAndRegions value for the named location policy.
Example 3: Update display name of a named location policy in Microsoft Entra ID by PolicyId
Connect-Entra -Scopes 'Policy.ReadWrite.ConditionalAccess'
$policy = Get-EntraNamedLocationPolicy | Where-Object {"$_.DisplayName -eq 'IP named location policy'"}
$params = @{
PolicyId = $policy.Id
OdataType = '#microsoft.graph.ipNamedLocation'
DisplayName = 'NewName'
}
Set-EntraNamedLocationPolicy @params
This command updates display name of named location policy in Microsoft Entra ID by PolicyId.
-PolicyId
parameter specifies the Id of a named location policy.-OdataType
parameter specifies the odata type of a named location policy.-DisplayName
parameter specifies the display name of a named location policy.
Parameters
-CountriesAndRegions
Specifies the countries and regions for the named location policy in Microsoft Entra ID.
Type: | System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.CountriesAndRegion] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisplayName
Specifies the display name of a named location policy in Microsoft Entra ID.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Specifies the Id of a named location policy in Microsoft Entra ID.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeUnknownCountriesAndRegions
Specifies the includeUnknownCountriesAndRegions value for the named location policy in Microsoft Entra ID.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IpRanges
List of IP address ranges in IPv4 CIDR format (e.g., 1.2.3.4/32) or any valid IPv6 format as specified in IETF RFC596. The @odata.type of the ipRange is also required.
Type: | System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.IpRange] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsTrusted
Specifies the IsTrusted
value for the named location policy in Microsoft Entra ID.
Type: | System.Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OdataType
Specifies the OData type of a named location policy object in Microsoft Entra ID.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PolicyId
Specifies the ID of a named location policy in Microsoft Entra ID.
Type: | System.String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |