Set-DeviceTenantRule

Modul:
Exchange PowerShell

Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.

Verwenden Sie das Set-DeviceTenantRule Cmdlet, um die Mandantenregel für mobile Geräte Ihrer organization in Basismobilität und Sicherheit in Microsoft 365 zu ändern.

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

Syntax

Default (Standard) 

Set-DeviceTenantRule
    [-Identity] <ComplianceRuleIdParameter>
    [-ApplyPolicyTo <PolicyResourceScope>]
    [-BlockUnsupportedDevices <Boolean>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ExclusionList <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

Beschreibung

Die Cmdlets in Basismobilität und Sicherheit werden in der folgenden Liste beschrieben:

  • DeviceTenantPolicy- und DeviceTenantRule-Cmdlets: Eine Richtlinie, die definiert, ob der Zugriff mobiler Geräte auf Exchange Online-E-Mails durch nicht unterstützte Geräte, die nur Exchange ActiveSync verwenden, blockiert oder zugelassen werden soll. Diese Einstellung gilt für alle Benutzer in Ihrer organization. Sowohl Zulassungs- als auch Blockszenarien ermöglichen die Berichterstellung für nicht unterstützte Geräte, und Sie können Ausnahmen für die Richtlinie basierend auf Sicherheitsgruppen angeben.
  • Cmdlets für DeviceConditionalAccessPolicy und DeviceConditionalAccessRule: Richtlinien, die den Zugriff mobiler Geräte auf Microsoft 365 für unterstützte Geräte steuern. Diese Richtlinien gelten für Sicherheitsgruppen. Nicht unterstützte Geräte dürfen sich nicht bei Basismobilität und Sicherheit registrieren.
  • DeviceConfigurationPolicy- und DeviceConfigurationRule-Cmdlets: Richtlinien, die Mobilgeräteeinstellungen für unterstützte Geräte steuern. Diese Richtlinien gelten für Sicherheitsgruppen.
  • Get-DevicePolicy: Gibt alle grundlegenden Richtlinien für Basismobilität und Sicherheit unabhängig vom Typ (DeviceTenantPolicy, DeviceConditionalAccessPolicy oder DeviceConfigurationPolicy) zurück.

Weitere Informationen zu Basismobilität und Sicherheit finden Sie unter Übersicht über Basismobilität und Sicherheit für Microsoft 365.

Um dieses Cmdlet in Security & Compliance PowerShell zu verwenden, müssen Ihnen Berechtigungen zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen im Microsoft Defender-Portal oder Berechtigungen im Microsoft Purview-Complianceportal.

Beispiele

Beispiel 1

Set-DeviceTenantRule -ExclusionList "Research and Development"

In diesem Beispiel wird die Mandantenregel für Mobilgeräte Ihrer Organisation geändert und die aktuelle Ausschlussliste durch die Sicherheitsgruppe „Research and Development“ ersetzt. Mitglieder dieser Gruppe erhalten auch dann Zugriff, wenn sie nicht kompatible Geräte verwenden.

Parameter

-ApplyPolicyTo

Anwendbar: Sicherheit & Compliance

Der Parameter ApplyPolicyTo gibt an, wo die Richtlinie in Ihrer organization angewendet werden soll. Der Parameter PasswordQuality gibt die Mindestbewertung für die Qualität von Kennwörtern an, die für Gerätekennwörter erforderlich ist. Kennwortqualität ist eine numerische Skala, die die Sicherheit und die Komplexität des Kennworts angibt. Ein höherer Qualitätswert signalisiert ein sichereres Kennwort.

  • ExchangeOnline
  • SharePoint Online
  • ExchangeAndSharePoint

Parametereigenschaften

Typ:PolicyResourceScope
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

-BlockUnsupportedDevices

Anwendbar: Sicherheit & Compliance

Der Parameter BlockUnsupportedDevices gibt an, ob der Zugriff auf Ihre organization durch nicht unterstützte Geräte blockiert werden soll. Der Parameter PasswordQuality gibt die Mindestbewertung für die Qualität von Kennwörtern an, die für Gerätekennwörter erforderlich ist. Kennwortqualität ist eine numerische Skala, die die Sicherheit und die Komplexität des Kennworts angibt. Ein höherer Qualitätswert signalisiert ein sichereres Kennwort.

  • $true: Nicht unterstützte Geräte werden blockiert.
  • $true: Nicht unterstützte Geräte werden gesperrt.

Parametereigenschaften

Typ:Boolean
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

-Confirm

Anwendbar: Sicherheit & Compliance

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

  • Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DomainController

Anwendbar: Sicherheit & Compliance

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

Parametereigenschaften

Typ:Fqdn
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

-ExclusionList

Anwendbar: Sicherheit & Compliance

Der Parameter ExclusionList gibt die Sicherheitsgruppen an, die von dieser Richtlinie ausgeschlossen werden sollen. Mitglieder der angegebenen Sicherheitsgruppen mit nicht konformen Geräten sind nicht von Zugriffssperraktionen betroffen.

Dieser Parameter verwendet den GUID-Wert der Gruppe. Um diesen GUID-Wert zu finden, führen Sie den Befehl Get-Group | Format-Table Name,GUID.

Verwenden Sie zum Eingeben mehrerer Werte und zum Überschreiben vorhandener Einträge die folgende Syntax: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Parametereigenschaften

Typ:MultiValuedProperty
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

-Identity

Anwendbar: Sicherheit & Compliance

Der Parameter "Identity" gibt den Namen der Mandantenregel für mobile Geräte an, die Sie ändern möchten, aber es gibt nur eine in Ihrer organization. Der Name der Regel ist eine GUID. Zum Beispiel 7577c5f3-05a4-4f55-a0a3-82aab5e98c84. Sie finden den Wert mithilfe des Befehls Get-DeviceTenantRule | Format-List Name.

Parametereigenschaften

Typ:ComplianceRuleIdParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

Anwendbar: Sicherheit & Compliance

Der WhatIf-Schalter funktioniert in Security & Compliance PowerShell nicht.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

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.