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.
Usare 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 a un gruppo specifico hanno la priorità sui criteri assegnati all'intero tenant quando si determina se una funzionalità è abilitata. Se un utente ha più criteri assegnati per una funzionalità (direttamente come utente o membro di un gruppo), si applicano i criteri più restrittivi.
- 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 funzionalità usando il cmdlet Get-VivaModuleFeature .
Alcune funzionalità includono l'opzione per i controlli utente (rifiuto esplicito dell'utente). Fare riferimento alla documentazione della funzionalità per verificare se i controlli utente sono disponibili per la funzionalità per cui si intende 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
Usare il cmdlet Update-VivaModuleFeaturePolicy per aggiornare un criterio di accesso per una funzionalità in un modulo Viva in 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).
- Indica se il criterio abilita o meno i controlli utente (parametro IsUserControlEnabled, applicabile solo a un criterio di funzionalità).
- 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.
Attualmente, è necessario essere un membro del ruolo Amministratori globali o i ruoli assegnati a livello di funzionalità per eseguire questo cmdlet.
Per altre informazioni sui ruoli assegnati a livello di funzionalità, vedere Funzionalità disponibili per la gestione degli accessi alle funzionalità.
Per altre informazioni sulle autorizzazioni del ruolo di amministratore nell Microsoft Entra ID, vedere ID modello di ruolo.
Importante
Microsoft sostiene fortemente il principio dei privilegi minimi. L'assegnazione degli account solo alle autorizzazioni minime necessarie per eseguire le attività consente di ridurre i rischi per la sicurezza e di rafforzare la protezione complessiva dell'organizzazione. 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
Questo 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.com
In 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.com
In 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,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com
Questo 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.
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. I criteri abilitano la funzionalità per gli utenti aggiunti in precedenza ai criteri, consentono i controlli utente e per impostazione predefinita hanno rifiutato gli utenti (criterio Disabilita soft).
Parametri
-Confirm
Applicabile: Exchange Online
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-*) 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, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente 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 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.
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 dei criteri da aggiornare.
Per visualizzare i dettagli sulle funzionalità di 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 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 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.
Nota: nella versione 3.5.1-Preview2 o successiva del modulo questo parametro supporta gli ID oggetto gruppo di sicurezza (GUID). Le versioni precedenti del modulo accettano solo indirizzi di posta elettronica 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 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.
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 rifiutare esplicitamente, assicurarsi di impostare il parametro IsUserControlEnabled quando si creano i criteri. In caso contrario, i controlli utente per i criteri usano lo stato predefinito per la funzionalità.
Il parametro IsUserControlEnabled specifica se il controllo utente è abilitato dai criteri. 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 in base ai criteri possono usare questo parametro. Se la funzionalità non supporta gli amministratori che attivano l'attivazione/ disattivazione dei controlli utente, viene applicato il valore predefinito. Per altre informazioni, vedere la documentazione sulle funzionalità.
Se non si vuole aggiornare se il controllo utente è abilitato dai criteri, 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 optato per impostazione predefinita dai criteri. I valori validi sono:
- $true: per impostazione predefinita, gli utenti sono optato per il criterio se l'utente non ha impostato una preferenza.
- $false: per impostazione predefinita, gli utenti vengono disattivati dal criterio se l'utente non ha impostato una preferenza.
Questo parametro è facoltativo e può essere usato per ignorare il valore predefinito di consenso esplicito dell'utente 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 dei criteri da 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, numeri, virgole, punti e spazi inglesi.
Se non si vuole 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 specifica i criteri per la funzionalità nel modulo Viva che si desidera 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.
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 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.
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 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.
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.