Disable-SPOSiteRestrictedAppAccessControl

Modulo:
Microsoft.Online.SharePoint.PowerShell Module

Disattiva l'applicazione delle restrizioni delle applicazioni per un sito mantenendo la modalità attiva ed entrambi gli elenchi.

Sintassi

Default (Impostazione predefinita) 

Disable-SPOSiteRestrictedAppAccessControl
    -Identity <String>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Usare il cmdlet per disattivare l'imposizione Disable-SPOSiteRestrictedAppAccessControl delle restrizioni dell'applicazione per un singolo sito mantenendo la modalità attiva ed entrambi gli elenchi. È possibile riabilitare la stessa configurazione in un secondo momento con Enable-SPOSiteRestrictedAppAccessControl.

La disabilitazione di un sito è diversa dalla sua cancellazione. Per rimuovere la modalità ed entrambi gli elenchi e cancellare completamente i criteri del sito archiviato, usare Clear-SPOSiteRestrictedAppAccessControlPolicy.

La configurazione e l'abilitazione sono ortogonali. Le modifiche alla modalità e all'elenco non attivano mai l'imposizione, quindi dopo aver disabilitato un sito è possibile continuare a eseguire modifiche di gestione temporanea con Set-SPOSiteRestrictedAppAccessControlMode e Set-SPOSiteRestrictedAppAccessControlList senza riattivare l'applicazione. L'imposizione del sito è attivata solo da Enable-SPOSiteRestrictedAppAccessControl.

Anche se il sito è disabilitato, nessuna decisione relativa alle restrizioni delle applicazioni a livello di sito si applica alle richieste per tale sito. I criteri a livello di tenant non sono interessati: il tenant cambia gate per tutte le imposizioni del sito e l'elenco di indirizzi non consentiti del tenant non può essere sostituito da un elenco di siti 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, quindi la disabilitazione di un criterio del sito non concede l'accesso alle applicazioni che non è già disponibile.

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.

Esempio

Esempio 1

Disable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance"

In questo esempio viene disattivata l'applicazione delle restrizioni delle applicazioni per il sito finanziario. La modalità attiva, l'elenco Consenti e l'elenco degli indirizzi non consentiti vengono mantenuti.

Esempio 2

Disable-SPOSiteRestrictedAppAccessControl -Identity "e1b2c3d4-5678-4abc-9def-0123456789ab" -WhatIf

Questo esempio usa un ID sito e mostra cosa accadrebbe senza modificare il criterio. Ogni cmdlet per le restrizioni delle applicazioni del sito accetta -Identity come URL del sito o come ID del sito.

Esempio 3

$url = "https://contoso.sharepoint.com/sites/Finance"
Disable-SPOSiteRestrictedAppAccessControl -Identity $url -Confirm:$false
Get-SPOSiteRestrictedAppAccessControl -Identity $url

In questo esempio viene disabilitata l'applicazione senza un prompt interattivo e quindi viene letto il criterio per verificare che la modalità ed entrambi gli elenchi siano ancora archiviati. L'uso -Confirm:$false non ignora la convalida, l'autorizzazione, il controllo o la protezione di prima parte.

Parametri

-Confirm

Applicabile: SharePoint Online

Richiede la conferma prima di eseguire il cmdlet. Questo cmdlet usa ConfirmImpact.High, quindi lo richiede per impostazione predefinita. Consente -Confirm:$false di eliminare la richiesta in automazione.

Proprietà dei parametri

Tipo:System.Management.Automation.SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: SharePoint Online

Specifica il sito da disabilitare. Specificare l'URL o l'ID del sito.

Proprietà dei parametri

Tipo:System.String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: SharePoint Online

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:System.Management.Automation.SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

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.

Input

None

Output

None

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

Note

  • La disabilitazione preserva la modalità attiva ed entrambi gli elenchi. Consente di Clear-SPOSiteRestrictedAppAccessControlPolicy rimuovere la modalità e gli elenchi e cancellare i criteri del sito archiviati.
  • L'imposizione del sito viene riattivata solo da Enable-SPOSiteRestrictedAppAccessControl. Le modifiche alla modalità e agli elenchi non attivano mai l'imposizione.
  • 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.