Update-VivaModuleFeaturePolicy
Questo cmdlet è disponibile solo nel modulo PowerShell di Exchange Online versione 3.2.0 o successiva. Per ulteriori informazioni, vedere Informazioni sul modulo PowerShell di Exchange Online.
Usa il cmdlet Update-VivaModuleFeaturePolicy per aggiornare un criterio di accesso per una funzionalità in un modulo Viva in Viva.
- Non è possibile aggiornare un criterio per un determinato utente o gruppo in modo da includere l'intero tenant se esiste già un criterio per l'intero tenant per la funzionalità. È supportato un solo criterio a livello di tenant.
- I criteri assegnati a un utente o un gruppo specifico hanno priorità rispetto ai criteri assegnati all'intero tenant nel determinare se una funzionalità è abilitata. Se a un utente sono assegnati più criteri per una funzionalità (direttamente come utente o membro di un gruppo), viene applicato il criterio più restrittivo.
- Alcune funzionalità supportano solo criteri che si applicano all'intero tenant, non a utenti o gruppi specifici. È possibile fare riferimento agli ambiti dei criteri supportati per una funzione utilizzando il cmdlet Get-VivaModuleFeature .
Alcune funzionalità includono l'opzione per i controlli utente (rifiuto esplicito dell'utente). Fai riferimento alla documentazione della funzionalità per verificare se sono disponibili controlli utente per la quale intendi impostare un criterio.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-Everyone <Boolean>]
[-IsFeatureEnabled <Boolean>]
[-IsUserControlEnabled <Boolean>]
[-IsUserOptedInByDefault <Boolean>]
[-GroupIds <String[]>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Usa il cmdlet Update-VivaModuleFeaturePolicy per aggiornare un criterio di accesso per una funzionalità in un modulo Viva in Viva.
Questo cmdlet aggiorna gli attributi del criterio specificato. Questi attributi includono:
- Nome del criterio (parametro Name).
- Indica se il criterio abilita o meno la funzionalità (parametro IsFeatureEnabled).
- Indica se il criterio abilita o meno i controlli utente (parametro IsUserControlEnabled, applicabile solo a un criterio di funzionalità).
- A chi si applica il criterio (i parametri UserIds e GroupIds o il parametro Everyone).
È possibile aggiornare questi attributi indipendentemente gli uni dagli altri. Ad esempio, se si specifica il parametro Name ma non il parametro IsFeatureEnabled, il nome del criterio viene aggiornato, ma il fatto che il criterio abiliti o meno la funzionalità rimane invariato.
Importante: i valori specificati per i parametri UserIds e/o GroupIds o per 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 altri utenti o gruppi da aggiungere. Se non si includono utenti o gruppi esistenti nel comando, questi utenti o gruppi specifici vengono rimossi dal criterio. Per ulteriori 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.
Attualmente, per eseguire questo cmdlet, è necessario essere un membro del ruolo Amministratori globali o dei ruoli assegnati a livello di funzionalità.
Per altre informazioni sui ruoli assegnati a livello di funzionalità, vedere Funzionalità disponibili per Gestione dell'accesso alle funzionalità.
Per altre informazioni sulle autorizzazioni del ruolo di amministratore in Microsoft Entra ID, vedere ID modello di ruolo.
Importante
Microsoft sostiene con forza il principio del privilegio minimo. Assegnare agli account solo le autorizzazioni minime necessarie per eseguire le attività consente di ridurre i rischi per la sicurezza e rafforzare la protezione complessiva dell'organizzazione. L'amministratore globale è un ruolo con privilegi elevati che in genere si limita agli scenari di emergenza o quando non è possibile usare un ruolo diverso.
Esempio
Esempio 1
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $false
In questo esempio viene aggiornato il nome del criterio specificato e fatto 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.com
Questo esempio aggiorna i destinatari dei criteri specificati. Il criterio ora si applica solo ai gruppi specificati, sovrascrivendo gli utenti e i gruppi a cui il criterio era usato per applicarsi.
Esempio 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.com
Questo esempio aggiorna i destinatari dei criteri specificati. Il criterio ora si applica solo agli utenti specificati, sovrascrivendo gli utenti e i gruppi a cui il criterio era usato per applicarsi.
Esempio 4
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com
In questo esempio viene aggiornato il nome del criterio specificato, fatto in modo che il criterio abiliti la funzionalità e aggiornamenti gli utenti a cui si applica il criterio. Il criterio ora si applica solo agli utenti e ai gruppi specificati, sovrascrivendo gli utenti e i gruppi a cui il criterio era usato per l'applicazione.
Esempio 5
Update-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false
Questo esempio aggiorna un criterio per la funzionalità ShowAISkills in Viva Skills. Il criterio abilita la funzionalità per gli utenti aggiunti in precedenza al criterio, consente i controlli utente e ha rifiutato esplicitamente gli utenti per impostazione predefinita (criterio di disabilitazione temporanea).
Parametri
-Confirm
Applicabile: Exchange Online
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.
- I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.
Proprietà dei parametri
| Tipo: | 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 |
-Everyone
Applicabile: Exchange Online
Il parametro Everyone specifica che il criterio aggiornato si applica a tutti gli utenti dell'organizzazione. I valori validi sono:
- $true: il criterio si applica a tutti gli utenti. Questo è l'unico valore utile per questo parametro.
- $false: non usare questo valore.
Se non si desidera aggiornare gli utenti a cui si applica il criterio, non usare questo parametro.
Non usare questo parametro con i parametri GroupIds o UserIds.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-FeatureId
Applicabile: Exchange Online
Il parametro FeatureId consente di specificare la funzionalità nel modulo Viva del criterio che si desidera 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.
Proprietà dei parametri
| Tipo: | 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 |
-GroupIds
Applicabile: Exchange Online
Il parametro GroupIds consente di specificare gli indirizzi di posta elettronica o gli ID oggetto del gruppo di sicurezza (GUID) dei gruppi a cui si applicano i criteri aggiornati. Sono supportati i gruppi di Microsoft Entra abilitati alla posta elettronica e non abilitati alla posta elettronica. È possibile immettere più valori separati da virgole.
Se non si desidera aggiornare gli utenti a cui si applica il criterio, non usare questo parametro.
I valori specificati per questo parametro o per il parametro UserIds sostituiscono tutti i gruppi esistenti. Per mantenere i gruppi esistenti, includerli insieme ai nuovi utenti o ai 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.
Nota: nella versione 3.5.1-Preview2 o successiva del modulo, questo parametro supporta gli ID oggetto del gruppo di sicurezza (GUID). Le versioni precedenti del modulo accettano solo indirizzi e-mail per questo parametro.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-IsFeatureEnabled
Applicabile: Exchange Online
Il parametro IsFeatureEnabled consente di specificare se la funzionalità è abilitata dai criteri aggiornati. I valori validi sono:
- $true: la funzionalità è abilitata dal criterio.
- $false: la funzionalità non è abilitata dal criterio.
Se non si desidera aggiornare l'indicazione dell'abilitazione della funzionalità in base al criterio, non usare questo parametro.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-IsUserControlEnabled
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione del modulo 3.3.0-Preview1 o successiva. Se la funzionalità supporta i controlli utente per il rifiuto esplicito, assicurarsi di impostare il parametro IsUserControlEnabled al momento della creazione del criterio. In caso contrario, i controlli utente per il criterio usano lo stato predefinito per la funzionalità.
Il parametro IsUserControlEnabled consente di specificare se il controllo utente è abilitato dal criterio. I valori validi sono:
- $true: il controllo utente è abilitato dai criteri. Gli utenti possono rifiutare esplicitamente la funzionalità.
- $false: il controllo utente non è abilitato dai criteri. Gli utenti non possono scegliere la funzionalità.
Solo le funzionalità che consentono agli amministratori di abilitare e disabilitare i controlli utente tramite criteri possono usare questo parametro. Se la funzionalità non supporta gli amministratori che attivano o disattivano i controlli utente, viene applicato il valore predefinito. Per altre informazioni, vedere la documentazione della funzionalità.
Se non si desidera aggiornare l'impostazione se il controllo utente è abilitato dal criterio, non usare questo parametro.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-IsUserOptedInByDefault
Applicabile: Exchange Online
Nota: questo parametro è disponibile nella versione del modulo 3.8.0-Preview2 o successiva.
Il parametro IsUserOptedInByDefault specifica se gli utenti sono stati inclusi per impostazione predefinita dal criterio. I valori validi sono:
- $true: Per impostazione predefinita, gli utenti vengono inclusi dal criterio se l'utente non ha impostato una preferenza.
- $false: Per impostazione predefinita, gli utenti vengono esclusi dal criterio se l'utente non ha impostato una preferenza.
Questo parametro è facoltativo e può essere usato per sostituire il valore di consenso esplicito dell'utente predefinito impostato nei metadati della funzionalità.
Questo parametro può essere impostato solo quando il parametro IsUserControlEnabled è impostato su $true.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-ModuleId
Applicabile: Exchange Online
Il parametro ModuleId consente di specificare il modulo Viva del criterio che si desidera aggiornare.
Proprietà dei parametri
| Tipo: | 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 |
-Name
Applicabile: Exchange Online
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 inglesi, numeri, virgole, punti e spazi.
Se non si desidera aggiornare il nome del criterio, non usare questo parametro.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-PolicyId
Applicabile: Exchange Online
Il parametro PolicyId consente di specificare i criteri per la funzionalità del modulo Viva che si desidera aggiornare.
Per visualizzare i dettagli sui criteri per una funzionalità in un modulo Viva, usa il cmdlet Get-VivaModuleFeaturePolicy. Il valore PolicyId viene restituito nell'output del cmdlet.
Proprietà dei parametri
| Tipo: | 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 |
-ResultSize
Applicabile: Exchange Online
Questo parametro è riservato all'uso interno da parte di Microsoft.
Proprietà dei parametri
| Tipo: | Unlimited |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-UserIds
Applicabile: Exchange Online
Il parametro UserIds consente di specificare i nomi delle entità utente (UPN) degli utenti a cui si applica il criterio aggiornato. È possibile immettere più valori separati da virgole.
Se non si desidera aggiornare gli utenti a cui si applica il criterio, non usare questo parametro.
I valori specificati per questo parametro o per il parametro GroupIds sostituiscono tutti 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.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
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 |
-WhatIf
Applicabile: Exchange Online
L'opzione WhatIf mostra le operazioni eseguite dal comando senza apportare modifiche. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | 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.