Get-VivaModuleFeaturePolicy
Dieses Cmdlet ist nur im Exchange Online PowerShell-Modul, Version 3.2.0 oder höher, verfügbar. Weitere Informationen finden Sie unter Informationen zum PowerShell-Modul von Exchange Online.
Verwenden Sie das Cmdlet Get-VivaModuleFeaturePolicy, um die Zugriffsrichtlinien für ein angegebenes Feature in einem Viva-Modul in Viva anzuzeigen. Richtlinien werden verwendet, um den Zugriff auf das angegebene Feature für bestimmte Benutzer, Gruppen oder den gesamten Mandanten einzuschränken oder zu gewähren. Dieses Cmdlet enthält Details zu den Richtlinien, einschließlich des Bezeichners, des Namens und des Erstellungsdatums der Richtlinie. Das Cmdlet kann Richtlinien basierend auf MemberIds filtern, sodass Administratoren für bestimmte Benutzer oder Gruppen spezifische Richtlinien anzeigen können.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
FeaturePolicy
Get-VivaModuleFeaturePolicy
[[-PolicyId] <String>]
-FeatureId <String>
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
FeaturePolicyWithMembers
Get-VivaModuleFeaturePolicy
[[-FeatureId] <String>]
[[-MemberIds] <String[]>]
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
Beschreibung
Verwenden Sie das Cmdlet Get-VivaModuleFeaturePolicy, um die Zugriffsrichtlinien für ein angegebenes Feature in einem Viva-Modul in Viva anzuzeigen.
Sie können alle Richtlinien für ein bestimmtes Feature in einem Viva-Modul in Viva anzeigen. Um eine bestimmte Richtlinie anzuzeigen, können Sie den PolicyId-Parameter einschließen.
Das Cmdlet kann Richtlinien basierend auf MemberIds filtern, sodass Administratoren für bestimmte Benutzer oder Gruppen spezifische Richtlinien anzeigen können.
Sie müssen das Cmdlet Connect-ExchangeOnline für die Authentifizierung verwenden.
Für dieses Cmdlet ist mindestens .NET Framework 4.7.2 erforderlich.
Derzeit müssen Sie der Rolle "Globale Administratoren" oder den Rollen angehören, die auf Featureebene zugewiesen wurden, um dieses Cmdlet auszuführen.
Weitere Informationen zu zugewiesenen Rollen auf Featureebene finden Sie unter Verfügbare Funktionen für die Verwaltung des Featurezugriffs.
Weitere Informationen zu Administratorrollenberechtigungen in Microsoft Entra ID finden Sie unter Rollenvorlagen-IDs.
Wichtig
Microsoft setzt sich nachdrücklich für das Prinzip der geringsten Privilegien ein. Wenn Sie Konten nur die minimalen Berechtigungen zuweisen, die für die Ausführung ihrer Aufgaben erforderlich sind, tragen Sie zur Verringerung der Sicherheitsrisiken bei und stärken den allgemeinen Schutz Ihrer Organization. Globale Administratorrolle ist eine hoch privilegierte Rolle, die Sie in der Regel auf Notfallszenarien beschränken oder wenn Sie keine andere Rolle verwenden können.
Beispiele
Beispiel 1
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection
Dieses Beispiel gibt Details zu allen Richtlinien zurück, die für das Feature "Reflektion" in Viva Insights hinzugefügt wurden.
Beispiel 2
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b
Dieses Beispiel gibt Details zu einer bestimmten Richtlinie wieder, die für das Feature "Reflektion" in Viva Insights hinzugefügt wurde.
Beispiel 3
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -MemberIds user1@contoso.com
In diesem Beispiel werden Details zu den Richtlinien für das Reflectionsfeature in Viva Insights zurückgegeben, die für den Benutzer mit der E-Mail user1@contoso.comgelten.
Beispiel 4
Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds user1@contoso.com,group1@contoso.com
Dieses Beispiel gibt Details zu den Richtlinien für alle Features in allen Viva-Modulen zurück, die für den Benutzer mit der E-Mail user1@contoso.com und die Gruppe mit der E-Mail group1@contoso.comgelten.
Parameter
-FeatureId
Anwendbar: Exchange Online
Der FeatureId-Parameter gibt das Feature im Viva-Modul an, für das Sie die Richtlinien anzeigen möchten.
Um Details zu den Features in einem Viva-Modul anzuzeigen, die Featurezugriffssteuerungen unterstützen, lesen Sie das Get-VivaModuleFeature Cmdlet. Die vom Get-VivaModuleFeature Cmdlet bereitgestellten Details enthalten den Featurebezeichner.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FeaturePolicy
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
FeaturePolicyWithMembers
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MemberIds
Anwendbar: Exchange Online
Hinweis: Dieser Parameter ist in Modulversion 3.8.1-Preview1 oder höher verfügbar.
Der Parameter MemberIds gibt die spezifischen Benutzer oder Gruppen an, für die Sie die Richtlinien für das Feature im Viva-Modul anzeigen möchten.
Sie können bis zu drei Mitglieds-IDs angeben. Verwenden Sie das Zeichen *, um alle Module oder Features anzugeben.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FeaturePolicyWithMembers
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ModuleId
Anwendbar: Exchange Online
Der Parameter ModuleId gibt das Viva-Modul der Featurerichtlinien an, die Sie anzeigen möchten.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PolicyId
Anwendbar: Exchange Online
Der PolicyId-Parameter gibt die spezifische Richtlinie für das Feature im Viva-Modul an, das Sie anzeigen möchten.
Führen Sie dieses Cmdlet ohne den PolicyId-Parameter aus, um Details zu allen Richtlinien für ein Feature in einem Viva-Modul anzuzeigen. Diese Details enthalten die IDs aller Richtlinien für ein Feature in einem Viva-Modul.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
FeaturePolicy
| Position: | Positional |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ResultSize
Anwendbar: Exchange Online
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.