Set-SPOSiteRestrictedAppAccessControlMode

Set-SPOSiteRestrictedAppAccessControlMode
    [-Identity] <String>
    -Mode <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Usa il cmdlet per modificare l'elenco Set-SPOSiteRestrictedAppAccessControlMode applicato da un sito. Questo cmdlet modifica solo la modalità attiva. Mantiene l'abilitazione del sito e sia l'elenco Consenti che l'elenco degli indirizzi non consentiti.

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.

La modalità attiva seleziona l'elenco che viene applicato:

• Consenti : le applicazioni nell'elenco Consenti superano il controllo Restrizioni applicazioni e tutte le altre applicazioni governate vengono negate dai criteri del sito. 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.
• Nega: le applicazioni nell'elenco degli indirizzi non consentiti vengono negate dai criteri del sito e tutte le altre applicazioni governate superano il controllo Restrizioni applicazioni. Un elenco di indirizzi non consentiti attivo vuoto indica che i criteri del sito non ne negano nessuno.

Entrambe le liste vengono sempre memorizzate e possono essere gestite indipendentemente dalla modalità attiva. Solo l'elenco selezionato dalla modalità attiva partecipa all'applicazione runtime. L'elenco degli inattivi viene mantenuto per le future modifiche della modalità e non ha alcun effetto di runtime. Prima di abilitare i criteri del sito, è necessario configurare in modo esplicito una modalità.

Poiché un cambio di modalità può modificare la decisione effettiva per ogni applicazione governata nel sito, il cmdlet visualizza un avviso prima di apportare la modifica. L'avviso identifica la modalità corrente, la modalità di destinazione, la dimensione dell'elenco mantenuto appena attivo e la nuova decisione predefinita e indica chiaramente che entrambi gli elenchi vengono mantenuti. Il cmdlet chiede quindi di confermare. Usare -WhatIf per visualizzare lo stesso impatto senza modificare il criterio.

La configurazione e l'abilitazione sono ortogonali: un cambio di modalità non attiva mai l'imposizione. L'imposizione del sito viene attivata solo da Enable-SPOSiteRestrictedAppAccessControl, quindi è possibile eseguire un'installazione di appoggio di una modalità e degli elenchi e quindi abilitare il sito in modo esplicito. L'unica combinazione che il backend rifiuta è abilitata con mode None.

L'imposizione del sito è gestita anche dal commutatore tenant. Mentre l'opzione tenant è attivata, l'elenco degli indirizzi non consentiti del tenant ha la precedenza e non può essere sostituito da un elenco di siti consentiti.

L'automazione può utilizzare lo standard -Confirm:$false. L'eliminazione della richiesta non ignora la convalida, l'autorizzazione, il controllo o la protezione di prima parte.

L'amministrazione delle restrizioni delle applicazioni del sito è isolata dai cmdlet per utilizzo Get-SPOSite generico e Set-SPOSite dai cmdlet. Get-SPOSite Non carica i dati dei criteri del sito e Set-SPOSite non può essere modificato. 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.

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow

In questo esempio la modalità attiva del sito Finance è impostata su Allow. Le applicazioni nell'elenco dei siti consentiti superano il controllo Restrizioni applicazioni e tutte le altre applicazioni regolamentate vengono negate dai criteri del sito. Il consenso Microsoft Entra esistente e l'autorizzazione SharePoint continuano ad applicarsi. L'elenco degli indirizzi non consentiti viene mantenuto ma diventa inattivo. Il cmdlet visualizza l'avviso del cambio di modalità e chiede conferma prima di applicare la modifica.

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Deny -WhatIf

In questo esempio viene visualizzato l'impatto del passaggio del sito Finance a Deny, inclusa la modalità corrente, la modalità di destinazione, le dimensioni dell'elenco degli indirizzi non consentiti appena attivo e la nuova decisione predefinita, senza modificare il criterio.

Set-SPOSiteRestrictedAppAccessControlMode -Identity 8a1e30f6-2f52-4b9e-9d1b-2e9f6c1d40aa -Mode Deny -Confirm:$false

In questo esempio viene impostato un sito identificato dal relativo ID su Deny senza chiedere conferma per l'uso nell'automazione. L'eliminazione della richiesta non ignora la convalida, l'autorizzazione, il controllo o la protezione di prima parte.

Set-SPOSiteRestrictedAppAccessControlMode -Identity https://contoso.sharepoint.com/sites/Finance -Mode Allow
Enable-SPOSiteRestrictedAppAccessControl -Identity https://contoso.sharepoint.com/sites/Finance

In questo esempio viene prima eseguita una fase della modalità e quindi l'applicazione viene attivata in modo esplicito. Una modifica di modalità non attiva mai l'applicazione da sola.

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.

• Un cambio di modalità cambia solo la modalità attiva. Mantiene l'abilitazione del sito ed entrambi gli elenchi.
• Prima del passaggio, il cmdlet segnala la modalità corrente, la modalità di destinazione, le dimensioni dell'elenco mantenuto appena attivo e la nuova decisione predefinita.
• L'avviso indica che entrambi gli elenchi vengono mantenuti e il cmdlet chiede conferma.
• 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.
• La configurazione e l'abilitazione sono ortogonali. L'imposizione del sito è attivata solo da Enable-SPOSiteRestrictedAppAccessControl. L'unica combinazione che il backend rifiuta è abilitata con mode None.
• Il tenant cambia gate per tutte le imposizioni del sito. Mentre l'opzione tenant è attivata, l'elenco degli indirizzi non consentiti del tenant non può essere sostituito da un elenco di siti consentiti.
• Usare Get-SPOSiteRestrictedAppAccessControl per confermare la modalità risultante ed entrambi gli elenchi.