Clear-SPOSiteRestrictedAppAccessControlPolicy

Clear-SPOSiteRestrictedAppAccessControlPolicy
    -Identity <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Usare il Clear-SPOSiteRestrictedAppAccessControlPolicy cmdlet per ripristinare lo stato non configurato di un sito. Il cmdlet disabilita l'imposizione, rimuove la modalità attiva ed entrambi gli elenchi e cancella i criteri del sito archiviato. Dopo che il criterio è stato cancellato, il sito si trova nello stesso stato di un sito che non è mai stato configurato: l'applicazione è disabilitata e non sono presenti voci.

La cancellazione è diversa dalla disabilitazione. Disable-SPOSiteRestrictedAppAccessControl Disattiva l'applicazione ma mantiene la modalità attiva ed entrambi gli elenchi in modo che la stessa configurazione possa essere riabilitata in un secondo momento. Utilizzare Clear-SPOSiteRestrictedAppAccessControlPolicy anche per rimuovere la configurazione. Per cancellare solo un elenco e mantenere l'altro elenco, la modalità e l'abilitazione del sito, usare Clear-SPOSiteRestrictedAppAccessControlList.

Poiché la modalità viene rimossa insieme agli elenchi, non è possibile abilitare di nuovo un sito cancellato finché non viene impostata una modalità. Enable-SPOSiteRestrictedAppAccessControl fallisce quando non è impostata alcuna modalità; Abilitato con la modalità None è l'unica combinazione che il backend rifiuta. Ricompila i criteri con Set-SPOSiteRestrictedAppAccessControlMode e Set-SPOSiteRestrictedAppAccessControlList, quindi abilitali in modo esplicito. La configurazione e l'abilitazione sono ortogonali: le modifiche alla modalità e agli elenchi non attivano mai l'imposizione, quindi un amministratore può eseguire una gestione temporanea di un criterio e quindi abilitarlo. 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.

La cancellazione di un criterio di sito influisce solo su tale sito. Il tenant passa tramite cancelli a tutte le imposizioni del sito e l'elenco di indirizzi non consentiti del tenant non può essere sostituito da un elenco di siti consentiti, pertanto la cancellazione di un criterio di sito non ripristina mai l'accesso per un'applicazione negata dal tenant. Da usare Clear-SPOTenantRestrictedAppAccessControlPolicy per l'ambito 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 Entra. Una richiesta deve superare sia il modello di autorizzazione esistente che le restrizioni dell'applicazione, quindi la cancellazione di un criterio di sito non concede alcun accesso alle applicazioni che non abbia già.

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-SPOSiteRestrictedAppAccessControlPolicy -Identity "https://contoso.sharepoint.com/sites/Finance"

In questo esempio viene rimosso il criterio completo Application Restrictions dal sito Finance. Disabilita l'applicazione e rimuove la modalità attiva, l'elenco Consenti e l'elenco Non consentiti.

Clear-SPOSiteRestrictedAppAccessControlPolicy -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -WhatIf

In questo esempio il sito viene identificato in base all'ID sito e viene visualizzata in anteprima la modifica senza modificare i criteri. 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-SPOSiteRestrictedAppAccessControlPolicy -Identity $url -Confirm:$false
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Deny
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType DenyList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url

In questo esempio viene rimosso un criterio esistente e quindi ricompilato da zero. Poiché la modalità viene rimossa quando il criterio viene cancellato, è necessario assegnare una modalità al sito prima di poterla abilitare.

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. Consente Get-SPOSiteRestrictedAppAccessControl di verificare che il sito non sia configurato.

• La cancellazione di un criterio del sito disabilita l'applicazione, rimuove la modalità attiva ed entrambi gli elenchi e cancella i criteri del sito archiviato. Un sito cancellato è indistinguibile da un sito che non è mai stato configurato.
• Per mantenere la configurazione per un uso successivo, utilizzare Disable-SPOSiteRestrictedAppAccessControl invece. Mantiene la modalità attiva ed entrambi gli elenchi.
• Per cancellare solo un elenco, usare Clear-SPOSiteRestrictedAppAccessControlList, che mantiene l'altro elenco, la modalità attiva e l'abilitazione del sito.
• Dopo la cancellazione, il sito non può essere abilitato finché non viene impostata una modalità. Enable-SPOSiteRestrictedAppAccessControl Ha esito negativo quando non è impostata alcuna modalità.
• 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.