Freigeben über


Update-VivaModuleFeaturePolicy

Dieses Cmdlet ist nur im Exchange Online PowerShell-Modul v3.2.0 oder höher verfügbar. Weitere Informationen finden Sie unter Informationen zum Exchange Online PowerShell-Moduls.

Hinweis: Dieses Cmdlet ist Teil eines Features, das sich derzeit in einer geschlossenen privaten Vorschau befindet. Das Cmdlet funktioniert nur, wenn Ihr organization Mitglied der privaten Vorschau ist.

Verwenden Sie das Cmdlet Update-VivaModuleFeaturePolicy, um eine Zugriffsrichtlinie für ein Feature in einem Viva-Modul zu aktualisieren. Die restriktivste Richtlinie für einen bestimmten Benutzer oder eine bestimmte Gruppe hat Priorität, wenn bestimmt wird, ob ein Feature aktiviert ist.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Update-VivaModuleFeaturePolicy
      -FeatureId <String>
      -ModuleId <String>
      -PolicyId <String>
      [-Confirm]
      [-IsFeatureEnabled <Boolean>]
      [-GroupIds <String[]>]
      [-Everyone <Boolean>]
      [-Name <String>]
      [-ResultSize <Unlimited>]
      [-UserIds <String[]>]
      [-WhatIf]
      [<CommonParameters>]

Beschreibung

Verwenden Sie das Cmdlet Update-VivaModuleFeaturePolicy, um eine Zugriffsrichtlinie für ein Feature in einem Viva-Modul zu aktualisieren.

Dieses Cmdlet aktualisiert die Attribute der richtlinie, die Sie angeben. Zu diesen Attributen gehören:

  • Der Richtlinienname (Name-Parameter).
  • Gibt an, ob die Richtlinie das Feature (IsFeatureEnabled-Parameter) aktiviert.
  • Für wen die Richtlinie gilt (die Parameter UserIds und GroupIds oder der Parameter Everyone).

Sie können diese Attribute unabhängig voneinander aktualisieren. Wenn Sie beispielsweise den Parameter Name angeben, aber nicht den Parameter IsFeatureEnabled, wird der Name der Richtlinie aktualisiert, aber ob die Richtlinie das Feature aktiviert, bleibt unverändert.

Wichtig: Werte, die Sie für die Parameter UserIds und/oder GroupIds oder den Parameter Everyone angeben, überschreiben alle vorhandenen Benutzer oder Gruppen. Um die vorhandenen Benutzer und Gruppen beizubehalten, müssen Sie diese vorhandenen Benutzer oder Gruppen sowie alle zusätzlichen Benutzer oder Gruppen angeben, die Sie hinzufügen möchten. Wenn vorhandene Benutzer oder Gruppen nicht in den Befehl eingeschlossen werden, werden diese spezifischen Benutzer oder Gruppen effektiv aus der Richtlinie entfernt. Weitere Informationen finden Sie in den Beispielen.

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" sein, um dieses Cmdlet ausführen zu können.

Weitere Informationen zu Administratorrollenberechtigungen in Azure Active Directory finden Sie unter Rollenvorlagen-IDs.

Beispiele

Beispiel 1

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $false

In diesem Beispiel wird der Name der angegebenen Richtlinie aktualisiert und so festgelegt, dass die Richtlinie das Feature nicht aktiviert.

Beispiel 2

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -GroupIds group1@contoso.com,group2@contoso.com

In diesem Beispiel wird aktualisiert, für wen die angegebene Richtlinie gilt. Die Richtlinie gilt jetzt nur für die angegebenen Gruppen und überschreibt die Benutzer und Gruppen, für die die Richtlinie angewendet wurde.

Beispiel 3

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.com

In diesem Beispiel wird aktualisiert, für wen die angegebene Richtlinie gilt. Die Richtlinie gilt jetzt nur für die angegebenen Benutzer und überschreibt die Benutzer und Gruppen, auf die die Richtlinie angewendet wurde.

Beispiel 4

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com -UserIds user1@contoso.com

In diesem Beispiel wird der Name der angegebenen Richtlinie aktualisiert, so dass die Richtlinie das Feature aktiviert und aktualisiert, für wen die Richtlinie gilt. Die Richtlinie gilt jetzt nur für die angegebenen Benutzer und Gruppen und überschreibt die Benutzer und Gruppen, für die die Richtlinie angewendet wurde.

Parameter

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

  • Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Everyone

Der Parameter Everyone gibt an, dass die aktualisierte Richtlinie für alle Benutzer im organization gilt. Gültige Werte sind:

  • $true: Die Richtlinie gilt für alle Benutzer. Dies ist der einzige nützliche Wert für diesen Parameter.
  • $false: Verwenden Sie diesen Wert nicht.

Wenn Sie nicht aktualisieren möchten, für wen die Richtlinie gilt, verwenden Sie diesen Parameter nicht.

Verwenden Sie diesen Parameter nicht mit den Parametern GroupIds oder UserIds.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-FeatureId

Der Parameter FeatureId gibt das Feature im Viva-Modul der Richtlinie an, die Sie aktualisieren möchten.

Um Details zu den Features in einem Viva-Modul anzuzeigen, die Featurezugriffssteuerungen unterstützen, verwenden Sie das Cmdlet Get-VivaModuleFeature. Der FeatureId-Wert wird in der Ausgabe des Cmdlets zurückgegeben.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-GroupIds

Der GroupIds-Parameter gibt die E-Mail-Adressen von Gruppen an, für die die aktualisierte Richtlinie gilt. E-Mail-aktivierte AAD-Gruppen werden unterstützt. Mehrere Werte können durch Kommata getrennt eingegeben werden.

Wenn Sie nicht aktualisieren möchten, für wen die Richtlinie gilt, verwenden Sie diesen Parameter nicht.

Die Werte, die Sie für diesen Parameter oder den Parameter UserIds angeben, ersetzen alle vorhandenen Gruppen. Um die vorhandenen Gruppen beizubehalten, schließen Sie sie zusammen mit allen neuen Benutzern oder Gruppen ein, die Sie angeben.

Sie können maximal 20 Benutzer oder Gruppen insgesamt angeben (20 Benutzer und keine Gruppen, 10 Benutzer und 10 Gruppen usw.).

Damit die aktualisierte Richtlinie für alle Benutzer im organization gilt, verwenden Sie den Parameter Jeder mit dem Wert $true.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-IsFeatureEnabled

Der Parameter IsFeatureEnabled gibt an, ob das Feature durch die aktualisierte Richtlinie aktiviert wird. Gültige Werte sind:

  • $true: Das Feature wird durch die Richtlinie aktiviert.
  • $false: Das Feature ist durch die Richtlinie nicht aktiviert.

Wenn Sie nicht aktualisieren möchten, ob das Feature durch die Richtlinie aktiviert ist, verwenden Sie diesen Parameter nicht.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ModuleId

Der Parameter ModuleId gibt das Viva-Modul der Richtlinie an, die Sie aktualisieren möchten.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Name

Der Name-Parameter gibt den aktualisierten Namen für die Richtlinie an. Die Höchstlänge beträgt 256 Zeichen. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Gültige Zeichen sind englische Buchstaben, Zahlen, Kommas, Punkte und Leerzeichen.

Wenn Sie den Namen der Richtlinie nicht aktualisieren möchten, verwenden Sie diesen Parameter nicht.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PolicyId

Der Parameter PolicyId gibt die Richtlinie für das Feature im Viva-Modul an, das Sie aktualisieren möchten.

Verwenden Sie das Cmdlet Get-VivaModuleFeaturePolicy, um Details zu den Richtlinien für ein Feature in einem Viva-Modul anzuzeigen. Der PolicyId-Wert wird in der Ausgabe des Cmdlets zurückgegeben.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UserIds

Der Parameter UserIds gibt die Benutzerprinzipalnamen (UPNs) von Benutzern an, für die die aktualisierte Richtlinie gilt. Mehrere Werte können durch Kommata getrennt eingegeben werden.

Wenn Sie nicht aktualisieren möchten, für wen die Richtlinie gilt, verwenden Sie diesen Parameter nicht.

Die Werte, die Sie für diesen Parameter oder den GroupIds-Parameter angeben, ersetzen alle vorhandenen Benutzer. Um die vorhandenen Benutzer beizubehalten, schließen Sie sie zusammen mit allen neuen Benutzern oder Gruppen ein, die Sie angeben.

Sie können maximal 20 Benutzer oder Gruppen insgesamt angeben (20 Benutzer und keine Gruppen, 10 Benutzer und 10 Gruppen usw.).

Damit die aktualisierte Richtlinie für alle Benutzer im organization gilt, verwenden Sie den Parameter Jeder mit dem Wert $true.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WhatIf

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online