Add-CMUserCollectionIncludeMembershipRule
Aggiungere una regola di appartenenza di inclusione a una raccolta di utenti.
Sintassi
Add-CMUserCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-CollectionName <String>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-CollectionId <String>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollection <IResultObject>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionId <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Add-CMUserCollectionIncludeMembershipRule
-InputObject <IResultObject>
-IncludeCollectionName <String>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Usare questo cmdlet per aggiungere una regola di appartenenza all'inclusione a una raccolta di utenti. Una regola di appartenenza include i membri di un'altra raccolta alla raccolta utenti in cui viene applicata la regola.
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
con . È possibile includere una raccolta predefinita, in modo che l'ID di una raccolta inclusa possa iniziare con SMS
.
Configuration Manager aggiorna dinamicamente l'appartenenza alla raccolta utenti in base a una pianificazione se cambia l'appartenenza alla raccolta inclusa.
Quando si aggiunge una regola di appartenenza all'inclusione a una raccolta, le risorse possono diventare membri della raccolta. Questa azione può causare l'applicazione di qualsiasi distribuzione di software o configurazione agli utenti nella raccolta inclusa.
Per altre informazioni, vedere Come creare raccolte in Configuration Manager.
Nota
Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>
. Per altre informazioni, vedere Introduzione.
Esempio
Esempio 1: Aggiungere una regola di appartenenza all'inclusione
Questo comando aggiunge la raccolta di utenti denominata Tutti gli utenti con una regola di appartenenza all'inclusione. La regola viene aggiunta alla raccolta utenti denominata Users.
Add-CMUserCollectionIncludeMembershipRule -CollectionName "Users" -IncludeCollectionName "All Users"
Parametri
-CollectionId
Specificare l'ID della raccolta utenti per aggiungere la regola. Questo valore è la proprietà CollectionID , ad esempio XYZ00012
. Poiché le raccolte predefinite non includono regole di appartenenza, questo ID inizia con il codice del sito e non SMS
con .
Type: | String |
Aliases: | Id |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Specificare il nome della raccolta utenti per aggiungere la regola.
Type: | String |
Aliases: | Name |
Position: | Named |
Default value: | None |
Required: | True |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollection
Specificare un oggetto per l'insieme incluso da aggiungere alla regola. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection o Get-CMUserCollection .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollectionId
Specificare l'ID della raccolta inclusa da aggiungere alla regola. Questo valore è la proprietà CollectionID , ad esempio XYZ00012
. È possibile includere raccolte predefinite, in modo che questo valore possa iniziare con il codice del sito o SMS
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeCollectionName
Specificare il nome della raccolta inclusa da aggiungere alla regola.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specificare un oggetto per la raccolta utenti per aggiungere la regola. Per ottenere questo oggetto, usare i cmdlet Get-CMCollection o Get-CMUserCollection .
Type: | IResultObject |
Aliases: | Collection |
Position: | Named |
Default value: | None |
Required: | True |
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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
System.Object
Collegamenti correlati
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per