Get-SPOTenantRestrictedAppAccessControl

Modulo:
Microsoft.Online.SharePoint.PowerShell Module

Restituisce i criteri di restrizioni delle applicazioni a livello di tenant, inclusi il commutatore di imposizione del tenant e l'elenco degli ID applicazioni con restrizioni a livello di tenant.

Sintassi

Default (Impostazione predefinita) 

Get-SPOTenantRestrictedAppAccessControl

Descrizione

Usare il Get-SPOTenantRestrictedAppAccessControl cmdlet per leggere i criteri completi relativi alle restrizioni delle applicazioni del tenant per l'organizzazione.

Restrizioni applicazioni aggiunge un limite di autorizzazione SharePoint per le applicazioni che dispongono già del consenso Microsoft Entra e delle autorizzazioni SharePoint. Non concede mai autorizzazioni e non sostituisce il consenso di Entra. Una richiesta deve superare sia il modello di autorizzazione esistente che le restrizioni dell'applicazione.

I criteri del tenant sono costituiti da due parti:

  • Abilitato : il parametro di applicazione principale per le restrizioni delle applicazioni. Quando questa opzione è disattivata, l'elenco degli indirizzi non consentiti del tenant e tutti i criteri a livello di sito non vengono applicati. La configurazione del tenant e del sito archiviata viene mantenuta. Quando l'opzione viene riattivata, l'elenco di indirizzi non consentiti e i criteri del sito del tenant il cui flag a livello Enabled di sito è True ripristinano l'applicazione con la stessa configurazione.
  • RestrictedAppIds : elenco di indirizzi non consentiti a livello di tenant. Quando l'opzione è attivata, le applicazioni in questo elenco vengono negate e l'elenco non può essere sostituito da un elenco di indirizzi consentiti a livello di sito.

L'elenco degli indirizzi non consentiti del tenant può contenere sia ID applicazione concreta che ID blueprint dell'agente padre. Un ID blueprint si applica all'applicazione blueprint stessa e a ogni app agente corrente o futura creata da tale blueprint. Il cmdlet non richiede di distinguere tra i due: RestrictedAppIds unisce le voci tipizzate internamente in un'unica voce stabile, priva Guid[]di duplicati.

Questo cmdlet restituisce lo stato autorevole dei criteri non memorizzati nella cache.

L'amministrazione delle restrizioni delle applicazioni del tenant è isolata dai cmdlet per utilizzo Get-SPOTenant generico e Set-SPOTenant dai cmdlet. Restrizioni applicazioni non è esposto come Tenant proprietà, quindi Get-SPOTenant non restituisce il criterio e Set-SPOTenant non può cambiarlo. Usare i cmdlet dedicati per le restrizioni delle applicazioni elencati nei collegamenti correlati.

Le applicazioni Microsoft di base e di prima parte sono escluse dalla configurazione e dall'applicazione delle restrizioni delle applicazioni e non vengono mai visualizzate nell'elenco degli indirizzi non consentiti del tenant.

Per le autorizzazioni e le informazioni più aggiornate su Windows PowerShell per SharePoint Online, vedere la documentazione online alla pagina Introduzione a SharePoint Online Management Shell.

Esempio

Esempio 1

Get-SPOTenantRestrictedAppAccessControl

Questo esempio restituisce il criterio completo di restrizioni delle applicazioni del tenant, mostrando se l'applicazione è abilitata e quali ID applicazione sono presenti nell'elenco degli indirizzi non consentiti del tenant.

Esempio 2

(Get-SPOTenantRestrictedAppAccessControl).RestrictedAppIds

Questo esempio restituisce solo gli ID applicazione con restrizioni dall'elenco degli indirizzi non consentiti del tenant.

Esempio 3

$policy = Get-SPOTenantRestrictedAppAccessControl
if (-not $policy.Enabled) {
    Write-Host "Application Restrictions enforcement is off. Site policies aren't enforced."
}

In questo esempio vengono archiviati i criteri tenant in una variabile e viene verificato il controllo del commutatore master. Poiché il commutatore tenant esegue il gate di tutte le applicazioni a livello di sito, un'opzione disabilitata indica che non vengono applicati criteri del sito, inclusi i criteri il cui contrassegno a livello Enabled di sito è True.

Esempio 4

$policy = Get-SPOTenantRestrictedAppAccessControl
if ($policy.Enabled -and $policy.RestrictedAppIds.Count -eq 0) {
    Write-Host "Enforcement is on, but the tenant deny list is empty and denies nothing."
}

In questo esempio un commutatore tenant abilitato viene identificato con un elenco di indirizzi non consentiti del tenant vuoto. Questo stato è valido. L'elenco di indirizzi non consentiti dal tenant non nega nulla fino a quando non viene aggiunto un ID applicazione; I criteri del sito il cui contrassegno a livello di Enabled sito è comunque True possibile applicare.

Input

None

Output

SPORestrictedAppAccessControlTenantPolicy

Restituisce un SPORestrictedAppAccessControlTenantPolicy oggetto con le proprietà seguenti.

Proprietà Tipo Descrizione
Enabled Booleano Indica se l'opzione di imposizione delle restrizioni delle applicazioni del tenant è attivata. Quando False, l'elenco degli indirizzi non consentiti e tutti i criteri a livello di sito non vengono applicati.
RestrictedAppIds Guid[] L'elenco degli indirizzi non consentiti a livello di tenant, restituito come un elenco stabile e privo di duplicati di ID applicazione e ID blueprint agente padre.

Note

  • Il commutatore tenant è il commutatore di imposizione principale per le restrizioni delle applicazioni. La disattivazione interrompe l'applicazione per ogni criterio del sito il cui flag a livello Enabled di sito è True, non solo per l'elenco degli indirizzi non consentiti del tenant.
  • Mentre l'opzione tenant è attivata, l'elenco tenant non consentiti ha la precedenza sui criteri del sito e non può essere sostituito da un elenco di siti consentiti.
  • L'ambito del tenant è solo nega e ha un singolo elenco, quindi non c'è alcuna modalità e nessuna selezione di tipo di elenco nell'ambito del tenant.
  • L'elenco degli indirizzi non consentiti del tenant include al massimo 100 ID applicazione.
  • La configurazione e l'abilitazione sono indipendenti: la modifica dell'elenco degli indirizzi non consentiti non attiva o disattiva mai l'interruttore del tenant.
  • Consente Get-SPOSiteRestrictedAppAccessControl di leggere i criteri di un singolo sito.