Get-EntraAuthorizationPolicy

Hiermee haalt u een autorisatiebeleid op.

Syntax

GetQuery (Standaard)

Get-EntraAuthorizationPolicy

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

GetById

Get-EntraAuthorizationPolicy

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

Description

De Get-EntraAuthorizationPolicy cmdlet haalt een Microsoft Entra ID autorisatiebeleid op.

In gedelegeerde scenario's met werk- of schoolaccounts moet de aangemelde gebruiker een ondersteunde Microsoft Entra- of aangepaste rol hebben met de vereiste machtigingen. De minst bevoegde rollen voor deze bewerking zijn:

  • Globale lezer
  • Lezer voor beveiligingsinformatie
  • Beveiligingsoperator
  • Beveiligingsbeheerder
  • Cloudapparaatbeheerder
  • Licentiebeheerder
  • Bevoorrechte Rollenbeheerder

Voorbeelden

Voorbeeld 1: Alle beleidsregels ophalen

Connect-Entra -Scopes 'Policy.Read.All'
Get-EntraAuthorizationPolicy
DeletedDateTime Description                                                       DisplayName          Id                  AllowEmailVerifiedUsersToJoinOrganization AllowI
                                                                                                                                                                     nvites
                                                                                                                                                                     From
--------------- -----------                                                       -----------          --                  ----------------------------------------- ------
                Used to manage authorization related settings across the company. Authorization Policy authorizationPolicy True                                      every…

In dit voorbeeld wordt het Microsoft Entra ID autorisatiebeleid verkregen.

Voorbeeld 2: Een autorisatiebeleid ophalen op id

Connect-Entra -Scopes 'Policy.Read.All'
Get-EntraAuthorizationPolicy -Id 'authorizationPolicy' | Format-List
allowInvitesFrom                          : everyone
allowUserConsentForRiskyApps              :
id                                        : authorizationPolicy
defaultUserRolePermissions                : @{allowedToCreateSecurityGroups=True; allowedToReadBitlockerKeysForOwnedDevice=True; allowedToCreateTenants=True;
                                            allowedToReadOtherUsers=True; allowedToCreateApps=False; permissionGrantPoliciesAssigned=System.Object[]}
blockMsolPowerShell                       : False
guestUserRoleId                           : a0b1b346-4d3e-4e8b-98f8-753987be4970
displayName                               : Authorization Policy
@odata.context                            : https://graph.microsoft.com/v1.0/$metadata#policies/authorizationPolicy/$entity
allowedToSignUpEmailBasedSubscriptions    : True
description                               : Used to manage authorization related settings across the company.
allowEmailVerifiedUsersToJoinOrganization : True
allowedToUseSSPR                          : True
DeletedDateTime                           :
AdditionalProperties                      : {}

In dit voorbeeld wordt het Microsoft Entra ID autorisatiebeleid verkregen.

  • -Id parameter geeft de unieke id van het autorisatiebeleid.

De antwoordeigenschappen zijn:

  • allowedToSignUpEmailBasedSubscriptions - geeft aan of gebruikers zich kunnen registreren voor e-mailabonnementen.
  • allowedToUseSSPR - geeft aan of beheerders van de tenant de Self-Service Wachtwoord opnieuw instellen (SSPR) kunnen gebruiken.
  • allowEmailVerifiedUsersToJoinOrganization - geeft aan of een gebruiker via e-mailvalidatie lid kan worden van de tenant.
  • allowInvitesFrom - geeft aan wie gasten kan uitnodigen voor de organisatie. Mogelijke waarden zijn: none, adminsAndGuestInviters, adminsGuestInvitersAndAllMembers, . everyone everyone is de standaardinstelling voor alle cloudomgevingen, met uitzondering van de Amerikaanse overheid.
  • allowUserConsentForRiskyApps - geeft aan of gebruikerstoestemming voor riskante apps is toegestaan. De standaardwaarde is false. U wordt aangeraden de waarde ingesteld te houden op false.
  • blockMsolPowerShell - als u het gebruik van de MSOnline PowerShell-module wilt uitschakelen, stelt u deze eigenschap in op true. Hierdoor wordt ook de toegang op basis van gebruikers tot het verouderde service-eindpunt uitgeschakeld dat wordt gebruikt door de MSOnline PowerShell-module. Dit heeft geen invloed op Microsoft Entra Connect of Microsoft Graph.
  • defaultUserRolePermissions - geeft bepaalde aanpasbare machtigingen op voor de standaardgebruikersrol.
  • description - beschrijving van dit beleid.
  • displayName - weergavenaam voor dit beleid.
  • enabledPreviewFeatures - lijst met functies die zijn ingeschakeld voor persoonlijke preview op de tenant.
  • guestUserRoleId -represents rol templateId voor de rol die aan gasten moet worden toegekend. Raadpleeg List unifiedRoleDefinitions om de lijst met beschikbare rolsjablonen te vinden. Momenteel worden de volgende rollen ondersteund: Gebruiker (a0b1b346-4d3e-4e8b-98f8-753987be4970), Gastgebruiker (10dae51f-b6af-4016-8d66-8c2a99b929b3) en beperkte gastgebruiker (2af84b1e-32c8-42b7-82bc-daa82404023b).
  • permissionGrantPolicyIdsAssignedToDefaultUserRole - geeft aan of gebruikerstoestemming voor apps is toegestaan en als dit het is, het app-toestemmingsbeleid dat de machtiging bepaalt voor gebruikers om toestemming te verlenen. Waarden moeten de indeling managePermissionGrantsForSelf.{id} hebben voor gebruikerstoestemmingsbeleid of managePermissionGrantsForOwnedResource.{id} voor resourcespecifieke toestemmingsbeleid, waarbij {id} de id is van een ingebouwd of aangepast app-toestemmingsbeleid. Een lege lijst geeft aan dat gebruikerstoestemming voor apps is uitgeschakeld.

Parameters

-Id

Hiermee geeft u de unieke id van het autorisatiebeleid.

Parametereigenschappen

Type:System.String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

GetById
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Property

Hiermee geeft u eigenschappen die moeten worden geretourneerd.

Parametereigenschappen

Type:

System.String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Selecteren

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.