Enable-SPOSiteRestrictedAppAccessControl

Modulo:
Microsoft.Online.SharePoint.PowerShell Module

Attiva l'applicazione delle restrizioni delle applicazioni per un sito usando la modalità e gli elenchi configurati.

Sintassi

Default (Impostazione predefinita) 

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

Descrizione

Usare il cmdlet per attivare l'applicazione Enable-SPOSiteRestrictedAppAccessControl delle restrizioni delle applicazioni per un singolo sito. Una modalità deve essere già configurata con Set-SPOSiteRestrictedAppAccessControlMode; il cmdlet ha esito negativo quando non è impostata alcuna modalità.

L'imposizione del sito viene attivata solo da questo cmdlet. La configurazione e l'abilitazione sono indipendenti: le modifiche alla modalità e all'elenco non attivano mai l'imposizione. Un amministratore può eseguire un'installazione di appoggio Set-SPOSiteRestrictedAppAccessControlList di un criterio e Set-SPOSiteRestrictedAppAccessControlMode quindi abilitarlo esplicitamente.

La modalità attiva determina la decisione dei criteri del sito:

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

L'elenco inattivo viene mantenuto e non ha alcun effetto di runtime.

Il tenant cambia gate per tutte le imposizioni del sito. Un criterio del sito non ha alcun effetto mentre l'opzione del tenant è disattivata e l'elenco degli indirizzi non consentiti del tenant non può essere sostituito da un elenco di siti consentiti. Da usare Get-SPOTenantRestrictedAppAccessControl per confermare il cambio tenant prima di affidarsi a un criterio sito.

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

Le applicazioni Microsoft di base e di prima parte sono escluse dalla configurazione e dall'applicazione delle restrizioni delle applicazioni.

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

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

In questo esempio viene attivata l'applicazione delle restrizioni delle applicazioni per il sito finanziario identificato dal relativo URL. Il controllo delle norme usa la modalità e gli elenchi già configurati nel sito.

Esempio 2

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

In questo esempio viene attivata l'applicazione per un sito identificato dal relativo ID. 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"
Set-SPOSiteRestrictedAppAccessControlMode -Identity $url -Mode Allow
Set-SPOSiteRestrictedAppAccessControlList -Identity $url -ListType AllowList -AddRestrictedAppIds "11111111-1111-1111-1111-111111111111"
Enable-SPOSiteRestrictedAppAccessControl -Identity $url

In questo esempio viene configurata una modalità e un elenco di indirizzi consentiti e quindi il criterio viene abilitato in modo esplicito. Le modifiche alla modalità e all'elenco non attivano l'imposizione, quindi non viene applicata nulla fino all'esecuzione del comando finale. Le applicazioni nell'elenco Consenti superano il controllo Restrizioni applicazioni; Tutte le altre applicazioni regolamentate sono negate dai criteri del sito. Il consenso Microsoft Entra esistente e l'autorizzazione SharePoint continuano ad applicarsi.

Esempio 4

Enable-SPOSiteRestrictedAppAccessControl -Identity "https://contoso.sharepoint.com/sites/Finance" -Confirm:$false

Questo esempio attiva l'applicazione 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.

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

  • Questo cmdlet non riesce quando nel sito non è configurata alcuna modalità. Impostare la modalità su Allow o Deny prima di abilitare il criterio.
  • L'imposizione del sito viene attivata solo da questo cmdlet. Le modifiche alla modalità e all'elenco mantengono lo stato di abilitazione corrente.
  • 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. Esaminare l'elenco attivo prima Get-SPOSiteRestrictedAppAccessControl di abilitare un sito.
  • In Deny modalità, le applicazioni rappresentate nell'elenco degli indirizzi non consentiti vengono negate dai criteri del sito. Tutte le altre applicazioni governate superano il controllo Restrizioni applicazioni.
  • 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.