Clear-SPOSiteRestrictedAppAccessControlList

Clear-SPOSiteRestrictedAppAccessControlList
    -Identity <String>
    -ListType <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Usare il Clear-SPOSiteRestrictedAppAccessControlList cmdlet per cancellare l'elenco Consenti o Non consentiti in un singolo sito. La cancellazione di un elenco preserva l'altro elenco, la modalità attiva e l'abilitazione del sito. Per rimuovere il criterio completo, usare Clear-SPOSiteRestrictedAppAccessControlPolicy.

Un sito archivia entrambi gli elenchi, ma solo l'elenco selezionato dalla modalità attiva partecipa all'applicazione:

• La modalità Consenti applica l'elenco Consenti. Le applicazioni elencate superano il controllo Restrizioni applicazioni e tutte le altre applicazioni governate vengono negate dai criteri del sito.
• La modalità Nega applica l'elenco degli indirizzi non consentiti. Le applicazioni elencate vengono rifiutate dai criteri del sito e tutte le altre applicazioni governate superano il controllo Restrizioni applicazioni.

Quando l'elenco cancellato è quello applicato dalla modalità attiva, il cmdlet genera un avviso prima della conferma. La cancellazione dell'elenco di indirizzi consentiti attivi causa il rifiuto da parte dei criteri di sito di tutte le applicazioni di terze parti e agenti regolamentate. Quando si cancella l'elenco degli indirizzi non consentiti attivi, i criteri del sito non negano più le applicazioni governate. Questo avviso descrive solo la decisione del criterio Restrizioni delle applicazioni e non significa mai che a un'applicazione viene concesso l'accesso. Il consenso Microsoft Entra esistente e l'autorizzazione SharePoint continuano ad applicarsi. L'avviso indica anche se la modifica ha effetto immediato o quando viene abilitata la successiva applicazione.

La cancellazione di un elenco inattivo non modifica l'applicazione corrente, ma supporta -WhatIf comunque e -Confirm, ed è controllato.

La configurazione e l'abilitazione sono ortogonali. Le modifiche agli elenchi non attivano mai l'imposizione, quindi la cancellazione di un elenco in un sito non abilitato lascia il sito disabilitato e granella della modifica per la volta successiva viene abilitata l'imposizione con Enable-SPOSiteRestrictedAppAccessControl. In questo modo si evita il pericoloso caso in cui l'aggiunta di un singolo ID a un sito non configurato attiverebbe immediatamente un elenco di indirizzi consentiti e bloccherebbe ogni altra applicazione.

Il tenant cambia gate per tutte le imposizioni del sito. Un criterio del sito non ha alcun effetto mentre la disattivazione del tenant è disattivata e l'elenco degli indirizzi non consentiti del tenant non può essere sostituito da un elenco di siti consentiti, pertanto la cancellazione di un elenco di siti non consentiti non ripristina mai l'accesso per un'applicazione negata dal tenant.

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.

L'amministrazione delle restrizioni delle applicazioni del sito è isolata dai cmdlet per utilizzo Get-SPOSite generico e Set-SPOSite dai cmdlet. Restrizioni applicazioni è completamente disaccoppiato da SiteProperties, quindi Get-SPOSite non carica i dati dei criteri del sito e Set-SPOSite non può modificarlo. Usare i cmdlet dedicati per le restrizioni delle applicazioni elencati nei collegamenti correlati.

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.

Clear-SPOSiteRestrictedAppAccessControlList -Identity "https://contoso.sharepoint.com/sites/Finance" -ListType DenyList

In questo esempio viene cancellato l'elenco degli indirizzi non consentiti nel sito Finance. Mantiene l'elenco Consenti, la modalità attiva e l'abilitazione del sito. Se Deny è la modalità attiva, il cmdlet avvisa che i criteri del sito non negano più le applicazioni governate nell'elenco. Il consenso Microsoft Entra esistente e l'autorizzazione SharePoint continuano ad applicarsi.

Clear-SPOSiteRestrictedAppAccessControlList -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -ListType AllowList -WhatIf

In questo esempio il sito viene identificato in base all'ID sito e vengono visualizzate in anteprima la cancellazione dell'elenco Consenti senza modificare il criterio. Ogni cmdlet per le restrizioni delle applicazioni del sito accetta -Identity come URL del sito o come ID del sito.

$url = "https://contoso.sharepoint.com/sites/Finance"
Clear-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"

In questo esempio viene ricostruito un elenco di indirizzi Consentiti da zero. Poiché le modifiche all'elenco sono di sola configurazione, nessuno dei due comandi cambia se il sito è abilitato.

Clear-SPOSiteRestrictedAppAccessControlList -Identity "https://contoso.sharepoint.com/sites/Finance" -ListType DenyList -Confirm:$false

In questo esempio viene cancellato l'elenco degli indirizzi non consentiti senza una richiesta di conferma interattiva, per l'uso nell'automazione. L'uso -Confirm:$false non ignora la convalida, l'autorizzazione, il controllo o la protezione di prima parte.

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

Questo cmdlet non restituisce un oggetto. Usare Get-SPOSiteRestrictedAppAccessControl per leggere i criteri risultanti.

• La cancellazione di un elenco preserva l'altro elenco, la modalità attiva e l'abilitazione del sito.
• La cancellazione dell'elenco imposto dalla modalità attiva modifica la decisione del criterio Restrizioni delle applicazioni. Un elenco di indirizzi consentiti attivi vuoto causa il rifiuto da parte dei criteri del sito di tutte le applicazioni di terze parti e agenti regolate. Un elenco di indirizzi non consentiti attivo vuoto indica che i criteri del sito non ne negano nessuno. Il consenso Microsoft Entra esistente e l'autorizzazione SharePoint continuano ad applicarsi. Il cmdlet avvisa prima della conferma e indica se la modifica ha effetto immediato o quando l'applicazione viene abilitata successivamente.
• La cancellazione di un elenco inattivo non modifica l'applicazione corrente, ma l'operazione continua a supportarla -WhatIf e -Confirm viene controllata.
• Le modifiche agli elenchi non attivano mai l'imposizione. L'imposizione del sito è attivata solo da Enable-SPOSiteRestrictedAppAccessControl.
• Il passaggio del tenant esegue il gate per l'applicazione di tutti i siti, quindi un criterio del sito non ha alcun effetto mentre il passaggio del tenant è disattivato. L'elenco degli indirizzi non consentiti del tenant non può essere sostituito da un elenco di siti consentiti.
• Le restrizioni dell'applicazione non concedono mai autorizzazioni. Una richiesta deve comunque superare l'autorizzazione SharePoint esistente.
• Questo cmdlet supporta -WhatIf e con ConfirmImpact.High.-Confirm -Confirm:$false è consentito per l'automazione e non ignora la convalida, l'autorizzazione, il controllo o la protezione di prima parte.