Get-VivaModuleFeatureEnablement

模組:
Exchange PowerShell

此 Cmdlet 僅適用於 Exchange Online PowerShell 模組版本 3.2.0 或更新版本。 如需詳細資訊，請參閱關於 Exchange Online PowerShell 模組。

使用 Get-VivaModuleFeatureEnablement Cmdlet 來檢視 Viva 模組中的某項功能是否針對特定使用者或群組啟用。 功能是否已啟用稱為功能的「啟用狀態」。 此 Cmdlet 傳回的啟用狀態是根據系統管理員設定的存取原則。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

語法

Default (預設值) 

Get-VivaModuleFeatureEnablement
    -FeatureId <String>
    -Identity <String>
    -ModuleId <String>
    [-Detailed]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Description

使用 Get-VivaModuleFeatureEnablement Cmdlet 來檢視 Viva 模組中的某項功能是否針對特定使用者或群組啟用。

您必須使用 Connect-ExchangeOnline Cmdlet 進行驗證。

這個 Cmdlet 需要 .NET Framework 4.7.2 或更新版本。

目前，您必須是全域系統管理員角色的成員，才能執行此 Cmdlet。

若要深入了解 Microsoft Entra ID 中的系統管理員角色權限，請參閱角色範本識別碼。

重要事項

Microsoft 強烈提倡最低權限原則。 僅為帳戶分配執行任務所需的最低權限有助於降低安全風險並加強組織的整體保護。 全域系統管理員是具有高度權限的角色，您通常會將其限制為緊急情況，或當您無法使用其他角色時。

範例

範例 1

Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com

此範例會傳回使用者 Viva Insights user@contoso.com 中反射功能的啟用狀態。

範例 2

Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity group@contoso.com

此範例會傳回群組 Viva Insights group@contoso.com 中反射功能的啟用狀態。

範例 3

Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com -Detailed

此範例會傳回使用者 Viva Insights user@contoso.com 中反射功能的啟用狀態。 回應已增強，以提供其他相關驅動功能啟用狀態之原則的資訊

參數

-Detailed

適用：Exchange Online

注意：此參數可在模組版本 3.8.1-Preview1 或更新版本中使用。

詳細開關透過提供更全面的資訊來增強命令的輸出。 您不需要使用此參數指定值。

此參數會傳回詳細的深入解析，包括相關原則及其有效性。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-FeatureId

適用：Exchange Online

FeatureId 參數會指定 Viva 模組中的功能。

若要檢視支援功能存取控制之 Viva 模組中功能的詳細資料，請參閱 Get-VivaModuleFeature Cmdlet。 Get-VivaModuleFeature Cmdlet 提供的詳細資料包括功能識別碼。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用：Exchange Online

Identity 參數會指定使用者的主體名稱 (使用者的 UPN) ，或您要檢視其功能啟用狀態之群組的 SMTP 位址 (電子郵件地址) 。

支援啟用郵件功能的 Microsoft Entra 群組。

警告： Identity 參數的值 $null 或不存在的值會傳回 所有 物件，就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤，且不包含不存在的$null值。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ModuleId

適用：Exchange Online

ModuleId 參數會指定 Viva 模組。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResultSize

適用：Exchange Online

將保留此參數供 Microsoft 內部使用。

參數屬性

類型:Unlimited
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。