Set-EntraNamedLocationPolicy

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>]

Este cmdlet permite a un administrador actualizar una directiva de ubicación con nombre en Microsoft Entra ID por PolicyId.

Las directivas de acceso condicional son reglas personalizadas que definen un escenario de acceso.

En escenarios delegados con cuentas profesionales o educativas, al actuar en otro usuario, el usuario que ha iniciado sesión debe tener un rol de Microsoft Entra compatible o un rol personalizado con los permisos necesarios. Entre los roles admitidos se incluyen:

• Administrador de seguridad
• Administrador de acceso condicional

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'
$type = '#microsoft.graph.ipNamedLocation'
Set-EntraNamedLocationPolicy -PolicyId $policy.Id -OdataType $type -IsTrusted $false -IncludeUnknownCountriesAndRegions $false -IpRanges $ipRanges

En este ejemplo se muestra cómo actualizar una directiva de ubicación con nombre IP en Microsoft Entra ID por PolicyId.

• -PolicyId el parámetro especifica el identificador de una directiva de ubicación con nombre.
• -OdataType parameter especifica el tipo de odata de una directiva de ubicación con nombre.
• -DisplayName parameter especifica el nombre para mostrar de una directiva de ubicación con nombre.
• -IsTrusted el parámetro especifica el valor IsTrusted de la directiva de ubicación con nombre.
• -IpRanges el parámetro especifica lista de intervalos de direcciones IP en formato CIDR IPv4 (por ejemplo, 1.2.3.4/32) o cualquier formato IPv6 válido tal como se especifica en IETF RFC596.

Connect-Entra -Scopes 'Policy.ReadWrite.ConditionalAccess'
$policy = Get-EntraNamedLocationPolicy | Where-Object { "$_.DisplayName -eq 'IP named location policy'" }
$type = '#microsoft.graph.countryNamedLocation'
Set-EntraNamedLocationPolicy -PolicyId $policy.Id -OdataType $type -IncludeUnknownCountriesAndRegions $true

Este comando actualiza una directiva de ubicación con nombre de país en Microsoft Entra ID por PolicyId.

• -PolicyId el parámetro especifica el identificador de una directiva de ubicación con nombre.
• -OdataType parameter especifica el tipo de odata de una directiva de ubicación con nombre.
• -IncludeUnknownCountriesAndRegions el parámetro especifica el valor includeUnknownCountriesAndRegions para la directiva de ubicación con nombre.

Connect-Entra -Scopes 'Policy.ReadWrite.ConditionalAccess'
$policy = Get-EntraNamedLocationPolicy | Where-Object { "$_.DisplayName -eq 'IP named location policy'" }
$type = '#microsoft.graph.ipNamedLocation'
Set-EntraNamedLocationPolicy -PolicyId $policy.Id -OdataType $type -DisplayName 'NewName'

Este comando actualiza el nombre para mostrar de la directiva de ubicación con nombre en Microsoft Entra ID por PolicyId.

• -PolicyId el parámetro especifica el identificador de una directiva de ubicación con nombre.
• -OdataType parameter especifica el tipo de odata de una directiva de ubicación con nombre.
• -DisplayName parameter especifica el nombre para mostrar de una directiva de ubicación con nombre.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.