Get-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 Get-VivaModuleFeaturePolicy per visualizzare i criteri di accesso per una funzionalità specificata in un modulo Viva in Viva. I criteri vengono usati per limitare o concedere l'accesso alla funzionalità specificata a utenti, gruppi specifici o all'intero tenant. Questo cmdlet fornisce informazioni dettagliate sui criteri, inclusi l'identificatore, il nome e la data di creazione del criterio. Il cmdlet può filtrare i criteri in base ai MemberIds, consentendo agli amministratori di visualizzare i criteri specifici per determinati utenti o gruppi.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

FeaturePolicy

Get-VivaModuleFeaturePolicy
    [[-PolicyId] <String>]
    -FeatureId <String>
    -ModuleId <String>
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

FeaturePolicyWithMembers

Get-VivaModuleFeaturePolicy
    [[-FeatureId] <String>]
    [[-MemberIds] <String[]>]
    -ModuleId <String>
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Descrizione

Usa il cmdlet Get-VivaModuleFeaturePolicy per visualizzare i criteri di accesso per una funzionalità specificata in un modulo Viva in Viva.

È possibile visualizzare tutti i criteri per una funzionalità specifica in un modulo Viva in Viva. Per visualizzare un criterio specifico, è possibile includere il parametro PolicyId.

Il cmdlet può filtrare i criteri in base ai MemberIds, consentendo agli amministratori di visualizzare i criteri specifici per determinati utenti o gruppi.

È 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

Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection

Questo esempio restituisce i dettagli su tutti i criteri aggiunti per la funzionalità Reflection in Viva Insights.

Esempio 2

Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b

Questo esempio restituisce i dettagli su un criterio specifico aggiunto per la funzionalità Reflection in Viva Insights.

Esempio 3

Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -MemberIds user1@contoso.com

Questo esempio restituisce i dettagli sui criteri per la funzionalità Reflection in Viva Insights che si applicano all'utente con il messaggio di posta elettronica user1@contoso.com.

Esempio 4

Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds user1@contoso.com,group1@contoso.com

Questo esempio restituisce i dettagli sui criteri per tutte le funzionalità in tutti i moduli Viva che si applicano all'utente con l'e-mail e al gruppo con l'e-mail user1@contoso.comgroup1@contoso.com.

Parametri

-FeatureId

Applicabile: Exchange Online

Il parametro FeatureId consente di specificare la funzionalità del modulo Viva per cui si vogliono visualizzare i criteri.

Per visualizzare i dettagli sulle funzionalità in un modulo Viva che supportano i controlli di accesso alle funzionalità, fai riferimento al cmdlet Get-VivaModuleFeature. I dettagli forniti dal cmdlet Get-VivaModuleFeature includono l'identificatore di funzionalità.

Proprietà dei parametri

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

Set di parametri

FeaturePolicy
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
FeaturePolicyWithMembers
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MemberIds

Applicabile: Exchange Online

Nota: questo parametro è disponibile nella versione del modulo 3.8.1-Preview1 o successiva.

Il parametro MemberIds consente di specificare gli utenti o i gruppi specifici per i quali si vogliono visualizzare i criteri per la funzionalità nel modulo Viva.

È possibile specificare fino a tre ID membro. Usare il carattere * per specificare tutti i moduli o le funzionalità.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

FeaturePolicyWithMembers
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 delle funzionalità che si desidera visualizzare.

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

-PolicyId

Applicabile: Exchange Online

Il parametro PolicyId consente di specificare i criteri specifici per la funzionalità del modulo Viva che si desidera visualizzare.

Per visualizzare i dettagli su tutti i criteri per una funzionalità in un modulo Viva, esegui questo cmdlet senza il parametro PolicyId. Questi dettagli includono gli identificatori di tutti i criteri per una funzionalità in un modulo Viva.

Proprietà dei parametri

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

Set di parametri

FeaturePolicy
Posizione:Positional
Obbligatorio:False
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:

Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32]

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

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.