Update-VivaModuleFeaturePolicy
Questo cmdlet è disponibile solo nel modulo Exchange Online PowerShell versione 3.2.0 o successiva. Per altre informazioni, vedere Informazioni sul modulo Exchange Online PowerShell.
Nota: questo cmdlet fa parte di una funzionalità attualmente disponibile in un'anteprima privata chiusa. Il cmdlet non funzionerà a meno che l'organizzazione non sia membro dell'anteprima privata.
Usare il cmdlet Update-VivaModuleFeaturePolicy per aggiornare un criterio di accesso per una funzionalità in un modulo Viva. I criteri più restrittivi per un determinato utente o gruppo hanno la priorità quando si determina se una funzionalità è abilitata.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-IsFeatureEnabled <Boolean>]
[-GroupIds <String[]>]
[-Everyone <Boolean>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>] Descrizione
Usare il cmdlet Update-VivaModuleFeaturePolicy per aggiornare un criterio di accesso per una funzionalità in un modulo Viva.
Questo cmdlet aggiorna gli attributi dei criteri specificati. Questi attributi includono:
- Nome del criterio (parametro Name).
- Indica se il criterio abilita o meno la funzionalità (parametro IsFeatureEnabled).
- A chi si applicano i criteri (i parametri UserIds e GroupIds o il parametro Everyone).
È possibile aggiornare questi attributi indipendentemente l'uno dall'altro. Ad esempio, se si specifica il parametro Name ma non il parametro IsFeatureEnabled, il nome del criterio viene aggiornato, ma se il criterio abilita o meno la funzionalità rimane invariato.
Importante: i valori specificati per i parametri UserIds e/o GroupIds o il parametro Everyone sovrascrivono tutti gli utenti o i gruppi esistenti. Per mantenere gli utenti e i gruppi esistenti, è necessario specificare gli utenti o i gruppi esistenti e gli eventuali utenti o gruppi aggiuntivi che si desidera aggiungere. Se non si includono utenti o gruppi esistenti nel comando, tali utenti o gruppi specifici vengono rimossi dai criteri. Per altre informazioni, vedere gli esempi.
È necessario usare il cmdlet Connect-ExchangeOnline per eseguire l'autenticazione.
Questo cmdlet richiede .NET Framework 4.7.2 o versione successiva.
Per eseguire questo cmdlet, è attualmente necessario essere membri del ruolo Amministratori globali.
Per altre informazioni sulle autorizzazioni dei ruoli di amministratore in Azure Active Directory, vedere ID modello di ruolo.
Esempio
Esempio 1
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $falseQuesto esempio aggiorna il nome del criterio specificato e lo rende in modo che il criterio non abiliti la funzionalità.
Esempio 2
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -GroupIds group1@contoso.com,group2@contoso.comIn questo esempio viene aggiornato l'oggetto a cui si applicano i criteri specificati. I criteri ora si applicano solo ai gruppi specificati, sovrascrivendo gli utenti e i gruppi a cui si applicano i criteri usati.
Esempio 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.comIn questo esempio viene aggiornato l'oggetto a cui si applicano i criteri specificati. I criteri ora si applicano solo agli utenti specificati, sovrascrivendo gli utenti e raggruppando i criteri a cui applicare.
Esempio 4
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com -UserIds user1@contoso.comQuesto esempio aggiorna il nome del criterio specificato, lo rende in modo che il criterio abilitare la funzionalità e aggiorna a chi si applica il criterio. I criteri ora si applicano solo agli utenti e ai gruppi specificati, sovrascrivendo gli utenti e i gruppi a cui applicare i criteri usati.
Parametri
-Confirm
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Everyone
Il parametro Everyone specifica che i criteri aggiornati si applicano a tutti gli utenti dell'organizzazione. I valori validi sono:
- $true: i criteri si applicano a tutti gli utenti. Questo è l'unico valore utile per questo parametro.
- $false: non usare questo valore.
Se non si vuole aggiornare a chi si applicano i criteri, non usare questo parametro.
Non usare questo parametro con i parametri GroupIds o UserIds.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-FeatureId
Il parametro FeatureId consente di specificare la funzionalità nel modulo Viva dei criteri da aggiornare.
Per visualizzare i dettagli sulle funzionalità in un modulo Viva che supportano i controlli di accesso alle funzionalità, usare il cmdlet Get-VivaModuleFeature. Il valore FeatureId viene restituito nell'output del cmdlet.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-GroupIds
Il parametro GroupIds consente di specificare gli indirizzi di posta elettronica dei gruppi a cui si applicano i criteri aggiornati. Sono supportati i gruppi AAD abilitati per la posta elettronica. È possibile immettere più valori separati da virgole.
Se non si vuole aggiornare a chi si applicano i criteri, non usare questo parametro.
I valori specificati per questo parametro o il parametro UserIds sostituiscono i gruppi esistenti. Per mantenere i gruppi esistenti, includerli insieme ai nuovi utenti o gruppi specificati.
È possibile specificare un massimo di 20 utenti o gruppi totali (20 utenti e nessun gruppo, 10 utenti e 10 gruppi e così via).
Per applicare i criteri aggiornati a tutti gli utenti dell'organizzazione, usare il parametro Everyone con il valore $true.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IsFeatureEnabled
Il parametro IsFeatureEnabled specifica se la funzionalità è abilitata dai criteri aggiornati. I valori validi sono:
- $true: la funzionalità è abilitata dai criteri.
- $false: la funzionalità non è abilitata dai criteri.
Se non si vuole aggiornare se la funzionalità è abilitata dai criteri, non usare questo parametro.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ModuleId
Il parametro ModuleId specifica il modulo Viva dei criteri da aggiornare.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
Il parametro Name consente di specificare il nome aggiornato per il criterio. La lunghezza massima è 256 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
I caratteri validi sono lettere, numeri, virgole, punti e spazi inglesi.
Se non si vuole aggiornare il nome del criterio, non usare questo parametro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-PolicyId
Il parametro PolicyId specifica i criteri per la funzionalità nel modulo Viva che si vuole aggiornare.
Per visualizzare i dettagli sui criteri per una funzionalità in un modulo Viva, usare il cmdlet Get-VivaModuleFeaturePolicy. Il valore PolicyId viene restituito nell'output del cmdlet.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UserIds
Il parametro UserIds consente di specificare i nomi dell'entità utente (UPN) degli utenti a cui si applicano i criteri aggiornati. È possibile immettere più valori separati da virgole.
Se non si vuole aggiornare a chi si applicano i criteri, non usare questo parametro.
I valori specificati per questo parametro o il parametro GroupIds sostituiscono gli utenti esistenti. Per mantenere gli utenti esistenti, includerli insieme ai nuovi utenti o gruppi specificati.
È possibile specificare un massimo di 20 utenti o gruppi totali (20 utenti e nessun gruppo, 10 utenti e 10 gruppi e così via).
Per applicare i criteri aggiornati a tutti gli utenti dell'organizzazione, usare il parametro Everyone con il valore $true.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-WhatIf
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
Collegamenti correlati
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per