Condividi tramite


Get-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 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 per utenti, gruppi o l'intero tenant specifici. 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 a MemberIds, consentendo agli amministratori di visualizzare i criteri specifici di 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

Usare 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à specificata in un modulo Viva in Viva. Per visualizzare un criterio specifico, è possibile includere il parametro PolicyId.

Il cmdlet può filtrare i criteri in base a MemberIds, consentendo agli amministratori di visualizzare i criteri specifici di 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, è 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

Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection

In questo esempio vengono restituiti 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

In questo esempio vengono restituiti 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

In questo esempio vengono restituiti 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

In questo esempio vengono restituiti i dettagli sui criteri per tutte le funzionalità di tutti i moduli di Viva che si applicano all'utente con il messaggio di posta elettronica user1@contoso.com e al gruppo con il messaggio di posta elettronica group1@contoso.com.

Parametri

-FeatureId

Applicabile: Exchange Online

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

Per visualizzare i dettagli sulle funzionalità in un modulo Viva che supportano i controlli di accesso alle funzionalità, vedere il 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 cui si desidera visualizzare i criteri per la funzionalità nel modulo Viva.

È possibile fornire 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 di 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à nel modulo Viva che si desidera visualizzare.

Per visualizzare i dettagli su tutti i criteri per una funzionalità in un modulo Viva, eseguire 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.