New-EntraPermissionGrantConditionSet

New-EntraPermissionGrantConditionSet

    -PolicyId <String>
    -ConditionSetType <String>
    [-Permissions <System.Collections.Generic.List`1[System.String]>]
    [-ClientApplicationTenantIds <System.Collections.Generic.List`1[System.String]>]
    [-ClientApplicationIds <System.Collections.Generic.List`1[System.String]>]
    [-ResourceApplication <String>]
    [-PermissionType <String>]
    [-PermissionClassification <String>]
    [-ClientApplicationsFromVerifiedPublisherOnly <Boolean>]
    [-ClientApplicationPublisherIds <System.Collections.Generic.List`1[System.String]>]
    [<CommonParameters>]

Crie um novo objeto de conjunto de condição de concessão de permissão do Microsoft Entra ID numa política existente.

Connect-Entra -Scopes 'Policy.ReadWrite.PermissionGrant'
$permissionGrantPolicy = Get-EntraPermissionGrantPolicy | Where-Object {$_.Id -eq 'my-custom-consent-policy'}
New-EntraPermissionGrantConditionSet -PolicyId $permissionGrantPolicy.Id -ConditionSetType 'includes' -PermissionType 'delegated'

Id                                   ClientApplicationIds ClientApplicationPublisherIds ClientApplicationTenantIds ClientApplicationsFromVerifiedPublisherOnly PermissionClassification PermissionType Permissions
--                                   -------------------- ----------------------------- -------------------------- ------------------------------------------- ------------------------ -------------- ---------
aaaa0000-bb11-2222-33cc-444444dddddd {all}                {all}                         {all}                      False                                       all                      delegated      {all}

Este comando cria uma condição básica de concessão de permissão definida numa política existente com todos os valores incorporados.

• -PolicyId O parâmetro especifica o identificador único de uma política de concessão de permissões.
• -ConditionSetType parâmetro indica se os conjuntos de condições estão incluídos na política ou excluídos.
• -PermissionType O parâmetro especifica o tipo de permissões (aplicação, delegadas) para definir a operação de consentimento até a.

Connect-Entra -Scopes 'Policy.ReadWrite.PermissionGrant'
$permission = (Get-EntraServicePrincipal -Filter "DisplayName eq 'Box'").AppRoles.Id
$permissionGrantPolicy = Get-EntraPermissionGrantPolicy | Where-Object { $_.Id -eq 'my-custom-consent-policy' }
New-EntraPermissionGrantConditionSet -PolicyId $permissionGrantPolicy.Id -ConditionSetType 'includes' -PermissionType 'delegated' -Permissions @($permission) -ResourceApplication 'resource-application-id'

Id                                   ClientApplicationIds ClientApplicationPublisherIds ClientApplicationTenantIds ClientApplicationsFromVerifiedPublisherOnly PermissionClassification PermissionType Permissions
--                                   -------------------- ----------------------------- -------------------------- ------------------------------------------- ------------------------ -------------- ---------
aaaa0000-bb11-2222-33cc-444444dddddd {all}                {all}                         {all}                      False                                       all                      delegated      {8b590...

Este comando cria uma condição de concessão de permissões definida numa política existente que inclui permissões específicas para uma aplicação de recurso.

• -PolicyId O parâmetro especifica o identificador único de uma política de concessão de permissões.
• -ConditionSetType parâmetro indica se os conjuntos de condições estão incluídos na política ou excluídos.
• -PermissionType O parâmetro especifica o tipo de permissões (aplicação, delegadas) para definir a operação de consentimento até a.
• -Permissions O parâmetro especifica o identificador da aplicação de recurso para definir a operação de consentimento até. Pode ser @("Todos") ou uma lista de IDs de permissões.
• -ResourceApplication O parâmetro especifica o identificador da aplicação de recurso para definir a operação de consentimento até. Pode ser "Qualquer" ou um ID de aplicação de recurso específico.

Connect-Entra -Scopes 'Policy.ReadWrite.PermissionGrant'
$permissionGrantPolicy = Get-EntraPermissionGrantPolicy | Where-Object { $_.Id -eq 'my-custom-consent-policy' }
$params = @{
    PolicyId                                    = $permissionGrantPolicy.Id
    ConditionSetType                            = 'excludes'
    PermissionType                              = 'delegated'
    Permissions                                 = @('All')
    ResourceApplication                         = 'a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'
    PermissionClassification                    = 'low'
    ClientApplicationsFromVerifiedPublisherOnly = $true
    ClientApplicationIds                        = @('All')
    ClientApplicationTenantIds                  = @('All')
    ClientApplicationPublisherIds               = @('All')
}
New-EntraPermissionGrantConditionSet @params

Id                                   CertifiedClientApplicationsOnly ClientApplicationIds ClientApplicationPublisherIds ClientApplicationTenantIds ClientApplicationsFromVerifiedPublisherOnly PermissionClassification
--                                   ------------------------------- -------------------- ----------------------------- -------------------------- ------------------------------------------- -------------------
dddd3333-ee44-5555-66ff-777777aaaaaa False                           {all}                {all}                         {all}                      True                                        low

Este comando cria uma condição de concessão de permissão definida numa política existente que está excluída.

• -PolicyId O parâmetro especifica o identificador único de uma política de concessão de permissões.
• -ConditionSetType parâmetro indica se os conjuntos de condições estão incluídos na política ou excluídos.
• -PermissionType O parâmetro especifica o tipo de permissões (aplicação, delegadas) para definir a operação de consentimento até a.
• -Permissions O parâmetro especifica o identificador da aplicação de recurso para definir a operação de consentimento até. Pode ser @("Todos") ou uma lista de IDs de permissões.
• -ResourceApplication O parâmetro especifica o identificador da aplicação de recurso para definir a operação de consentimento até. Pode ser "Qualquer" ou um ID de aplicação de recurso específico.
• -PermissionClassification O parâmetro especifica a classificação específica (todos, baixo, médio, alto) para o âmbito da operação de consentimento até a.
• -ClientApplicationsFromVerifiedPublisherOnly O parâmetro indica se deve incluir apenas aplicações clientes de editores verificados.
• -ClientApplicationIds O parâmetro especifica o conjunto de IDs de aplicação cliente a definir a operação de consentimento até . Pode ser @("Todos") ou uma lista de IDs de aplicações de clientes.
• -ClientApplicationTenantIds o parâmetro especifica o conjunto de IDs de editores de aplicações clientes para definir a operação de consentimento até a. Pode ser @("Todos") ou uma lista de IDs de publicadores de aplicações clientes.
• -ClientApplicationPublisherIds o parâmetro especifica o conjunto de IDs de editores de aplicações clientes para definir a operação de consentimento até a. Pode ser @("Todos") ou uma lista de IDs de publicadores de aplicações clientes.

Connect-Entra -Scopes 'Policy.ReadWrite.PermissionGrant'
$permissionGrantPolicy = Get-EntraPermissionGrantPolicy | Where-Object { $_.Id -eq 'my-custom-consent-policy' }
$permission = (Get-EntraServicePrincipal -Filter "DisplayName eq '<service-principal-displayname>'").AppRoles.Id
$params = @{
    PolicyId                                    = $permissionGrantPolicy.Id
    ConditionSetType                            = 'excludes'
    PermissionType                              = 'delegated'
    Permissions                                 = @($permission)
    ResourceApplication                         = 'a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1'
    PermissionClassification                    = 'low'
    ClientApplicationsFromVerifiedPublisherOnly = $true
    ClientApplicationIds                        = @('00001111-aaaa-2222-bbbb-3333cccc4444', '11112222-bbbb-3333-cccc-4444dddd5555')
    ClientApplicationTenantIds                  = @('aaaabbbb-0000-cccc-1111-dddd2222eeee', 'bbbbcccc-1111-dddd-2222-eeee3333ffff', 'ccccdddd-2222-eeee-3333-ffff4444aaaa')
    ClientApplicationPublisherIds               = @('33334444-dddd-5555-eeee-6666ffff7777')
}
New-EntraPermissionGrantConditionSet @params

Id                                   CertifiedClientApplicationsOnly ClientApplicationIds                                                         ClientApplicationPublisherIds          ClientApplicationTenantIds
--                                   ------------------------------- --------------------                                                         -----------------------------          --------------------
cccccccc-2222-3333-4444-dddddddddddd False                           {33334444-dddd-5555-eeee-6666ffff7777} {d5aec55f-2d12-4442-8d2f-ccca95d4390e} {aaaabbbb-0000-cccc-1111-dddd2222eeee}

Este comando cria uma condição de concessão de permissão definida numa política existente que está excluída.

• -PolicyId O parâmetro especifica o identificador único de uma política de concessão de permissões.
• -ConditionSetType parâmetro indica se os conjuntos de condições estão incluídos na política ou excluídos.
• -PermissionType O parâmetro especifica o tipo de permissões (aplicação, delegadas) para definir a operação de consentimento até a.
• -Permissions O parâmetro especifica o identificador da aplicação de recurso para definir a operação de consentimento até. Pode ser @("Todos") ou uma lista de IDs de permissões.
• -ResourceApplication O parâmetro especifica o identificador da aplicação de recurso para definir a operação de consentimento até. Pode ser "Qualquer" ou um ID de aplicação de recurso específico.
• -PermissionClassification O parâmetro especifica a classificação específica (todos, baixo, médio, alto) para o âmbito da operação de consentimento até a.
• -ClientApplicationsFromVerifiedPublisherOnly O parâmetro indica se deve incluir apenas aplicações clientes de editores verificados.
• -ClientApplicationIds O parâmetro especifica o conjunto de IDs de aplicação cliente a definir a operação de consentimento até . Pode ser @("Todos") ou uma lista de IDs de aplicações de clientes.
• -ClientApplicationTenantIds o parâmetro especifica o conjunto de IDs de editores de aplicações clientes para definir a operação de consentimento até a. Pode ser @("Todos") ou uma lista de IDs de publicadores de aplicações clientes.
• -ClientApplicationPublisherIds o parâmetro especifica o conjunto de IDs de editores de aplicações clientes para definir a operação de consentimento até a. Pode ser @("Todos") ou uma lista de IDs de publicadores de aplicações clientes.

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.