Add-CMUserCollectionExcludeMembershipRule
Fügen Sie einer Benutzersammlung eine Ausschlussmitgliedschaftsregel hinzu.
Syntax
Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionName <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-CollectionId <String>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
-InputObject <IResultObject>
-ExcludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Verwenden Sie dieses Cmdlet, um einer Benutzersammlung eine Ausschlussmitgliedschaftsregel hinzuzufügen. Eine __ Ausschlussmitgliedschaftsregel schließt die Mitglieder einer anderen Auflistung aus den Benutzersammlungen aus, auf die die Regel angewendet wird.
Sie können Standardsammlungen keine Mitgliedschaftsregeln hinzufügen. Jede Auflistung, auf die Sie abzielen, sollte eine ID aufweisen, die mit dem Websitecode beginnt, nicht SMS
. Sie können eine Standardsammlung ausschließen, sodass die ID einer ausgeschlossenen Auflistung mit beginnen SMS
kann.
Configuration Manager aktualisiert die Mitgliedschaft der Benutzersammlung dynamisch nach einem Zeitplan, wenn sich die Mitgliedschaft der ausgeschlossenen Sammlung ändert.
Wenn Sie einer Auflistung eine Ausschlussmitgliedschaftsregel hinzufügen, ist eine Ressource möglicherweise kein Mitglied der Benutzersammlung mehr. Diese Aktion kann dazu führen, dass jede Software- oder Konfigurationsbereitstellung nicht auf einen Benutzer angewendet wird.
Weitere Informationen finden Sie unter Erstellen von Sammlungen in Configuration Manager.
Hinweis
Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\>
aus. Weitere Informationen finden Sie unter "Erste Schritte".
Beispiele
Beispiel 1: Hinzufügen einer Ausschlusssammlungsregel zu einer Benutzersammlung
Dieser Befehl schließt die Elemente der Remotebenutzersammlung mit der ID XYZ00017aus der Benutzersammlung mit DER ID XYZ00012aus.
Add-CMUserCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "XYZ00017"
Parameter
-CollectionId
Geben Sie die ID der Benutzersammlung an, der die Regel hinzugefügt werden soll. Dieser Wert ist die CollectionID-Eigenschaft, z. XYZ00012
B. . Da Standardsammlungen keine Mitgliedschaftsregeln ausschließen, beginnt diese ID mit dem Websitecode und nicht SMS
.
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Geben Sie den Namen der Benutzersammlung an, der die Regel hinzugefügt werden soll.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeCollection
Geben Sie ein Objekt für die ausgeschlossene Auflistung an, um die Regel hinzuzufügen. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets "Get-CMCollection" oder "Get-CMUserCollection".
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeCollectionId
Geben Sie die ID der ausgeschlossenen Auflistung an, um die Regel hinzuzufügen. Dieser Wert ist die CollectionID-Eigenschaft, z. XYZ00012
B. . Sie können Standardsammlungen ausschließen, sodass dieser Wert entweder mit dem Websitecode oder beginnen SMS
kann.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExcludeCollectionName
Geben Sie den Namen der ausgeschlossenen Auflistung an, um die Regel hinzuzufügen.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Geben Sie ein Objekt für die Benutzerauflistung an, um die Regel hinzuzufügen. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets "Get-CMCollection" oder "Get-CMUserCollection".
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object