Get-EntraNamedLocationPolicy

Modul:
Microsoft.Entra.SignIns Module v1.3

Ruft eine Microsoft Entra ID benannte Standortrichtlinie ab.

Syntax

GetQuery (Standard) 

Get-EntraNamedLocationPolicy

    [-Property <String[]>]
    [<CommonParameters>]

GetById 

Get-EntraNamedLocationPolicy

    -PolicyId <String>
    [-Property <String[]>]
    [<CommonParameters>]

Beschreibung

Mit diesem Cmdlet kann ein Administrator die Microsoft Entra ID benannten Standortrichtlinien abrufen.

Benannte Speicherorte sind benutzerdefinierte Regeln, die Netzwerkspeicherorte definieren, die dann in einer Richtlinie für bedingten Zugriff verwendet werden können.

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. Die am wenigsten privilegierten Rollen für diesen Vorgang sind:

  • Globaler Administrator für den sicheren Zugriff (schreibgeschützte Standardeigenschaften)
  • Sicherheitsleseberechtigter (schreibgeschützte Standardeigenschaften)
  • Sicherheitsadministrator (schreibgeschützte Standardeigenschaften)
  • Globaler Leser
  • Administrator für bedingten Zugriff

Beispiele

Beispiel 1: Ruft eine Liste aller benannten Standortrichtlinien in Microsoft Entra ID

Connect-Entra -Scopes 'Policy.Read.All'
Get-EntraNamedLocationPolicy

Id                                   CreatedDateTime      DisplayName    ModifiedDateTime
--                                   ---------------      -----------    ----------------
dddddddd-3333-4444-5555-eeeeeeeeeeee 31/07/2024 9:53:10   NamedLocation   31/07/2024 9:53:10
eeeeeeee-4444-5555-6666-ffffffffffff 31/07/2024 4:38:42   NamedLocation1  31/07/2024 4:38:42
ffffffff-5555-6666-7777-aaaaaaaaaaaa 01/08/2024 4:39:42   NamedLocation2  01/08/2024 4:39:42
aaaaaaaa-6666-7777-8888-bbbbbbbbbbbb 01/08/2024 4:57:03   NamedLocation3  01/08/2024 4:57:03

Mit diesem Befehl wird eine Liste aller benannten Standortrichtlinien in Microsoft Entra ID abgerufen.

Beispiel 2: Ruft eine benannte Standortrichtlinie anhand der ID ab.

Connect-Entra -Scopes 'Policy.Read.All'
$policy = Get-EntraNamedLocationPolicy | Where-Object { $_.DisplayName -eq 'Provisioning Workers' }
Get-EntraNamedLocationPolicy -PolicyId $policy.Id

Id                                   CreatedDateTime      DisplayName    ModifiedDateTime
--                                   ---------------      -----------    ----------------
dddddddd-3333-4444-5555-eeeeeeeeeeee 3/1/2024 9:53:10 AM  NamedLocation  3/1/2024 9:53:10 AM

In diesem Beispiel wird eine angegebene benannte Standortrichtlinie in Microsoft Entra ID abgerufen.

  • -PolicyId der Parameter gibt die Richtlinien-ID einer benannten Standortrichtlinie an.

Parameter

-PolicyId

Gibt die ID einer benannten Standortrichtlinie in Microsoft Entra ID an.

Parametereigenschaften

Typ:System.String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetById
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Property

Gibt eigenschaften an, die zurückgegeben werden sollen.

Parametereigenschaften

Typ:

System.String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Select

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

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.