Remove-CMCollectionDirectMembershipRule

Referenz

Modul:: ConfigurationManager

Entfernen sie eine Regel für direkte Mitgliedschaften aus einem Gerät oder einer Benutzersammlung.

Syntax

Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -CollectionName <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -CollectionId <String>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -Resource <IResultObject[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceId <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMCollectionDirectMembershipRule
      -InputObject <IResultObject>
      -ResourceName <String[]>
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Regel für direkte Mitgliedschaften von einem Gerät oder einer Benutzersammlung zu entfernen. Mit einer Regel für direkte Mitgliedschaft können Sie explizit die Mitglieder der Auflistung auswählen. Standardsammlungen verfügen nicht über direkte Mitgliedschaftsregeln. Jede Auflistung, auf die Sie abzielen, sollte eine ID aufweisen, die mit dem Websitecode beginnt, nicht SMS . Weitere Informationen finden Sie unter Erstellen von Sammlungen in Configuration Manager.

Wenn Sie eine Regel für direkte Mitgliedschaften aus einer Auflistung entfernen, ist die Ressource möglicherweise kein Mitglied der Auflistung mehr. Diese Aktion kann dazu führen, dass jede Software- oder Konfigurationsbereitstellung nicht auf die Ressource angewendet wird.

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: Entfernen des lokalen Computers aus einer Sammlung von Testgeräten

In diesem Beispiel wird die Windows-Umgebungsvariable ComputerName verwendet, um sie aus der Auflistung mit dem Namen Test Deviceszu entfernen. Der Parameter "Force" wird verwendet, um keine Bestätigungsaufforderung zu erhalten.

Remove-CMCollectionDirectMembershipRule -CollectionName 'Test Devices' -ResourceName $env:ComputerName -Force

Parameter

-CollectionId

Geben Sie die ID der Auflistung mit der direkten Regel an, die entfernt werden soll. Beispiel: "XYZ0003F".

Type:	String
Aliases:	Id
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

Geben Sie den Namen der Auflistung mit der zu entfernenden direkten Regel an.

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:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Führen Sie den Befehl aus, ohne um Bestätigung zu bitten.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Geben Sie ein Auflistungsobjekt mit der direkten Regel an, die entfernt werden soll. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets "Get-CMCollection", "Get-CMDeviceCollection"oder "Get-CMUserCollection".

Type:	IResultObject
Aliases:	Collection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Resource

Geben Sie ein Array von Ressourcenobjekten an, die aus der Auflistung entfernt werden sollen. Verwenden Sie zum Abrufen dieses Objekts die Cmdlets "Get-CMResource", "Get-CMDevice"oder "Get-CMUser".

Type:	IResultObject[]
Aliases:	Resources
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceId

Geben Sie ein Array von Ressourcen-IDs an, die aus der Auflistung entfernt werden sollen. Dieser Wert ist die ResourceId-Eigenschaft der SMS_Resource Klasse. Beispiel: "33555693".

Type:	String[]
Aliases:	ResourceIds
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceName

Geben Sie ein Array von Ressourcennamen an, die aus der Auflistung entfernt werden sollen.

Type:	String[]
Aliases:	ResourceNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	True

-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:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object

Hinweise

Dieses Cmdlet ist mit "Remove-CMDeviceCollectionDirectMembershipRule" und "Remove-CMUserCollectionDirectMembershipRule" vergleichbar, die für den Sammlungstyp spezifisch sind. Dieses Cmdlet kann mit Geräte- oder Benutzersammlungen verwendet werden.