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

Mit diesem Cmdlet kann ein Administrator eine benannte Standortrichtlinie in Microsoft Entra ID von PolicyId aktualisieren.

Richtlinien für bedingten Zugriff sind benutzerdefinierte Regeln, die ein Zugriffsszenario definieren.

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss der angemeldete Benutzer über eine unterstützte Microsoft Entra Rolle oder benutzerdefinierte Rolle mit den erforderlichen Berechtigungen verfügen. Zu den unterstützten Rollen gehören:

• Sicherheitsadministrator
• Administrator für bedingten Zugriff

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

In diesem Beispiel wird gezeigt, wie Eine IP-benannte Standortrichtlinie in Microsoft Entra ID von PolicyId aktualisiert wird.

• -PolicyId der Parameter gibt die ID einer benannten Standortrichtlinie an.
• -OdataType der Parameter gibt den odata-Typ einer benannten Standortrichtlinie an.
• -DisplayName der Parameter gibt den Anzeigenamen einer benannten Standortrichtlinie an.
• -IsTrusted der Parameter gibt den IsTrusted-Wert für die benannte Standortrichtlinie an.
• -IpRanges parameter specifies List of IP address ranges in IPv4 CIDR format (z.B. 1.2.3.4/32) or any valid IPv6 format as specified in 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

Mit diesem Befehl wird eine Länderrichtlinie mit dem Namen "Standort" in Microsoft Entra ID von "PolicyId" aktualisiert.

• -PolicyId der Parameter gibt die ID einer benannten Standortrichtlinie an.
• -OdataType der Parameter gibt den odata-Typ einer benannten Standortrichtlinie an.
• -IncludeUnknownCountriesAndRegions der Parameter gibt den includeUnknownCountriesAndRegions-Wert für die benannte Standortrichtlinie an.

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'

Mit diesem Befehl wird der Anzeigename der benannten Standortrichtlinie in Microsoft Entra ID von PolicyId aktualisiert.

• -PolicyId der Parameter gibt die ID einer benannten Standortrichtlinie an.
• -OdataType der Parameter gibt den odata-Typ einer benannten Standortrichtlinie an.
• -DisplayName der Parameter gibt den Anzeigenamen einer benannten Standortrichtlinie an.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.