Add-CMDeviceCollectionDirectMembershipRule

Riferimento

Modulo:: ConfigurationManager

Aggiungi una regola di appartenenza diretta a una raccolta di dispositivi.

Sintassi

Add-CMDeviceCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-CMDeviceCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Utilizzare questo cmdlet per aggiungere una regola di appartenenza diretta a una raccolta di dispositivi. Una regola di appartenenza diretta ti consente di scegliere esplicitamente i membri della raccolta di dispositivi. Non è possibile aggiungere regole di appartenenza alle raccolte predefinite. Qualsiasi raccolta di destinazione deve avere un ID che inizia con il codice del sito, non SMS . Per ulteriori informazioni, vedere Come creare raccolte in Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\> . Per ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1: Aggiungere una regola di appartenenza diretta

Questo comando aggiunge una regola di appartenenza diretta alla raccolta di dispositivi con ID XYZ00056. Aggiunge la risorsa con ID 16777219 alla raccolta.

Add-CMDeviceCollectionDirectMembershipRule -CollectionId "XYZ00056" -ResourceId 16777219

Esempio 2: Aggiungere una regola di appartenenza diretta tramite la pipeline

Questo comando utilizza innanzitutto il cmdlet Get-CMCollection per ottenere l'oggetto insieme denominato testCollection. Viene quindi utilizzato l'operatore della pipeline per passare l'oggetto al cmdlet Add-CMDeviceCollectionDirectMembershipRule, che aggiunge la regola di appartenenza diretta all'oggetto insieme di dispositivi. Aggiunge il dispositivo con ID 16777219 alla raccolta.

Get-CMCollection -Name "testCollection" | Add-CMDeviceCollectionDirectMembershipRule -ResourceId 16777219

Parametri

-CollectionId

Specifica l'ID della raccolta di dispositivi per aggiungere la regola. Questo valore è la proprietà CollectionID, ad esempio XYZ00012 . Poiché non è possibile aggiungere regole di appartenenza alle raccolte predefinite, questo ID inizia con il codice del sito e non con SMS .

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

-CollectionName

Specifica il nome della raccolta di dispositivi per aggiungere la regola.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-ForceWildcardHandling

Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.

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

-InputObject

Specificare un oggetto per l'insieme di dispositivi per aggiungere la regola. Per ottenere questo oggetto, utilizzare i cmdlet Get-CMCollection o Get-CMDeviceCollection.

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

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

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

-Resource

Specifica una matrice di oggetti risorsa da aggiungere all'insieme di dispositivi con questa regola di appartenenza diretta. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMResource o il cmdlet Get-CMDevice con il -Resource parametro .

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

-ResourceId

Specifica una matrice di ID delle risorse da aggiungere alla raccolta di dispositivi con questa regola di appartenenza diretta. Questo valore è la proprietà ResourceID, ad esempio 16777219 .

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object