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

Esse cmdlet permite que um administrador atualize uma política de localização nomeada em Microsoft Entra ID por PolicyId.

As políticas de acesso condicional são regras personalizadas que definem um cenário de acesso.

Em cenários delegados com contas corporativas ou de estudante, ao agir em outro usuário, o usuário conectado deve ter suporte Microsoft Entra função ou função personalizada com as permissões necessárias. As funções suportadas incluem:

• Administrador de segurança
• Administrador de Acesso 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

Este exemplo mostra como atualizar uma política de local nomeada de IP no Microsoft Entra ID por PolicyId.

• -PolicyId o parâmetro especifica a ID de uma política de local nomeada.
• -OdataType O parâmetro especifica o tipo odata de uma política de local nomeada.
• -DisplayName o parâmetro especifica o nome de exibição de uma política de local nomeada.
• -IsTrusted o parâmetro especifica o valor IsTrusted para a política de local nomeada.
• -IpRanges O parâmetro especifica a lista de intervalos de endereços IP no formato CIDR IPv4 (por exemplo, 1.2.3.4/32) ou qualquer formato IPv6 válido, conforme especificado no 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

Esse comando atualiza uma política de local nomeada de país no Microsoft Entra ID por PolicyId.

• -PolicyId o parâmetro especifica a ID de uma política de local nomeada.
• -OdataType O parâmetro especifica o tipo odata de uma política de local nomeada.
• -IncludeUnknownCountriesAndRegions o parâmetro especifica o valor includeUnknownCountriesAndRegions para a política de localização nomeada.

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 atualiza o nome de exibição da política de local nomeada em Microsoft Entra ID por PolicyId.

• -PolicyId o parâmetro especifica a ID de uma política de local nomeada.
• -OdataType O parâmetro especifica o tipo odata de uma política de local nomeada.
• -DisplayName o parâmetro especifica o nome de exibição de uma política de local nomeada.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.