Get-VivaModuleFeaturePolicy
Dieses Cmdlet ist nur in version 3.2.0 oder höher des Exchange Online PowerShell-Moduls verfügbar. Weitere Informationen finden Sie unter Informationen zum Exchange Online PowerShell-Moduls.
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 Bezeichner, Name und Erstellungsdatum der Richtlinie. Das Cmdlet kann Richtlinien basierend auf MemberIds filtern, sodass Administratoren Richtlinien anzeigen können, die für bestimmte Benutzer oder Gruppen spezifisch sind.
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 angegebenes Feature in einem Viva-Modul in Viva anzeigen. Um eine bestimmte Richtlinie anzuzeigen, können Sie den Parameter PolicyId einschließen.
Das Cmdlet kann Richtlinien basierend auf MemberIds filtern, sodass Administratoren Richtlinien anzeigen können, die für bestimmte Benutzer oder Gruppen spezifisch sind.
Sie müssen das Cmdlet Connect-ExchangeOnline verwenden, um sich zu authentifizieren.
Dieses Cmdlet erfordert die .NET Framework 4.7.2 oder höher.
Derzeit müssen Sie Mitglied der Rolle "Globale Administratoren" oder der Rollen sein, die auf Featureebene zugewiesen wurden, um dieses Cmdlet ausführen zu können.
Weitere Informationen zu zugewiesenen Rollen auf Featureebene finden Sie unter Verfügbare Features für die Featurezugriffsverwaltung.
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 Rechte ein. Wenn Sie Konten nur die minimalen Berechtigungen zuweisen, die zum Ausführen ihrer Aufgaben erforderlich sind, können Sie Sicherheitsrisiken reduzieren und den allgemeinen Schutz Ihrer organization stärken. Globaler Administrator ist eine Rolle mit hohen Berechtigungen, 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
In diesem Beispiel werden Details zu allen Richtlinien zurückgegeben, die für das Reflektionsfeature in Viva Insights hinzugefügt wurden.
Beispiel 2
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b
In diesem Beispiel werden Details zu einer bestimmten Richtlinie zurückgegeben, die für das Reflektionsfeature 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 Reflektionsfeature 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
In diesem Beispiel werden Details zu den Richtlinien für alle Features in allen Viva Modulen zurückgegeben, 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 Parameter FeatureId gibt das Feature im Viva Modul an, für das Sie die Richtlinien anzeigen möchten.
Details zu den Features in einem Viva-Modul, die Featurezugriffssteuerungen unterstützen, finden Sie im Cmdlet Get-VivaModuleFeature. Die vom Cmdlet Get-VivaModuleFeature 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 MemberIds-Parameter 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 die 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 Parameter PolicyId gibt die spezifische Richtlinie für das Feature im Viva Modul an, das Sie anzeigen möchten.
Um Details zu allen Richtlinien für ein Feature in einem Viva-Modul anzuzeigen, führen Sie dieses Cmdlet ohne den PolicyId-Parameter aus. Diese Details enthalten die Bezeichner 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.