Get-SPOTenantRestrictedAppAccessControl

Get-SPOTenantRestrictedAppAccessControl

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.

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.

(Get-SPOTenantRestrictedAppAccessControl).RestrictedAppIds

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

$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.

$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.

Restituisce un SPORestrictedAppAccessControlTenantPolicy oggetto con le proprietà seguenti.

• 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.