Condividi tramite

Get-CMCollectionDirectMembershipRule

  • Riferimento
Modulo:
ConfigurationManager

Ottenere una regola di appartenenza diretta per un dispositivo o una raccolta di utenti.

Sintassi

Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   [-ResourceName <String>]
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionName <String>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -CollectionId <String>
   [-ResourceName <String>]
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   -Resource <IResultObject>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   -ResourceId <String>
   [<CommonParameters>]
Get-CMCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-ResourceName <String>]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per ottenere una o più regole di appartenenza diretta per un dispositivo o una raccolta di utenti. Una regola di appartenenza diretta consente di scegliere in modo esplicito i membri della raccolta di dispositivi. Le raccolte predefinite non hanno regole di appartenenza diretta. Qualsiasi raccolta di destinazione deve avere un ID che inizia con il codice del sito, non SMScon . Per altre 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 altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Ottenere tutte le regole di appartenenza diretta per una raccolta in base al nome

Questo comando ottiene le regole di appartenenza diretta per la raccolta denominata Device01.

Get-CMCollectionDirectMembershipRule -CollectionName "Device01"

Esempio 2: Ottenere tutte le regole di appartenenza diretta usando la pipeline

Questo comando usa il cmdlet Get-CMCollection per ottenere l'oggetto raccolta denominato User02. Usa quindi l'operatore della pipeline per passare l'oggetto al cmdlet Get-CMCollectionDirectMembershipRule .

Get-CMCollection -Name "User02" | Get-CMCollectionDirectMembershipRule

Parametri

-CollectionId

Specificare l'ID della raccolta per ottenere la regola. Questo valore è la proprietà CollectionID , ad esempio XYZ00012. Poiché le raccolte predefinite non possono avere regole di appartenenza diretta, questo ID inizia con il codice del sito e non SMScon .

Tipo:String
Alias:Id
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CollectionName

Specificare il nome della raccolta per ottenere la regola.

Tipo:String
Alias:Name
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto per la raccolta per ottenere la regola. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection, Get-CMDeviceCollection o Get-CMUserCollection .

Tipo:IResultObject
Alias:Collection
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Resource

Specificare una risorsa, un dispositivo o un oggetto utente per ottenere la regola di appartenenza diretta dalla raccolta. Per ottenere questo oggetto, usare i cmdlet Get-CMResource, Get-CMDevice o Get-CMUser .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceId

Specificare l'ID della risorsa per ottenere la regola di appartenenza diretta dalla raccolta. Questo valore è la proprietà ResourceID , ad esempio 16777219.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ResourceName

Specificare il nome del dispositivo o dell'utente per ottenere la regola di appartenenza diretta dalla raccolta.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object

Note

Questo cmdlet è simile a Get-CMDeviceCollectionDirectMembershipRule e Get-CMUserCollectionDirectMembershipRule, specifici del tipo di raccolta. Questo cmdlet funziona con le raccolte di dispositivi o utenti.