Compartilhar via

Set-CMCollectionCloudSync

Módulo:
ConfigurationManager Module

Configure a sincronização de associação de coleções para Microsoft Entra grupos para uma coleção de dispositivos ou utilizadores. Para obter mais informações, veja How to synchronize collection members to Microsoft Entra groups (Como sincronizar membros da coleção com grupos de Microsoft Entra)

Sintaxe

SetByValue (Default) 

Set-CMCollectionCloudSync
    -InputObject <IResultObject#SMS_Collection>
    [-AddGroupName <string[]>]
    [-EnableAssignEndpointSecurityPolicy <bool>]
    [-RemoveGroupName <string[]>]
    [-TenantId <string>]
    [-TenantName <string>]
    [-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetById 

Set-CMCollectionCloudSync
    -Id <string>
    [-AddGroupName <string[]>]
    [-EnableAssignEndpointSecurityPolicy <bool>]
    [-RemoveGroupName <string[]>]
    [-TenantId <string>]
    [-TenantName <string>]
    [-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByName 

Set-CMCollectionCloudSync
    -Name <string>
    [-AddGroupName <string[]>]
    [-EnableAssignEndpointSecurityPolicy <bool>]
    [-RemoveGroupName <string[]>]
    [-TenantId <string>]
    [-TenantName <string>]
    [-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Utilize este cmdlet para configurar a sincronização de associação de coleções para Microsoft Entra grupos para uma coleção de dispositivos ou utilizadores.

Observação

Execute Configuration Manager cmdlets a partir da unidade de site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Ativar uma coleção para sincronizar membros com Microsoft Entra grupo

O primeiro comando obtém o objeto de coleção com o nome testUserCollection e armazena-o na variável $userCollection . O segundo comando obtém o inquilino Microsoft Entra com o nome contoso e armazena-o na variável $AADTenant. O terceiro comando ativa a sincronização da coleção com Microsoft Entra grupo denominado testUserGroup pertencente ao nome do inquilino "contoso"

$userCollection = Get-CMCollection -Name "testUserCollection"
$AADTenant = Get-CMAADTenant -Name "contoso"
Set-CMCollectionCloudSync -InputObject $userCollection -AddGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantObject $AADTenant

Exemplo 2: Remover a sincronização de coleções com Microsoft Entra grupo

O primeiro comando obtém o objeto de coleção com o nome testUserCollection e armazena-o na variável $userCollection . O segundo comando remove a sincronização da coleção com Microsoft Entra grupo denominado testUserGroup pertencente ao nome do inquilino "contoso", que é transmitido como valor para o parâmetro -TenantName. Em alternativa, o parâmetro -TenantId também pode ser utilizado.

$userCollection = Get-CMCollection -Name "testUserCollection"
Set-CMCollectionCloudSync -InputObject $userCollection -RemoveGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantName "contoso"

Parâmetros

-AddGroupName

Especifique o destino Microsoft Entra nome do grupo com o qual os membros da coleção têm de ser sincronizados.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EnableAssignEndpointSecurityPolicy

Utilize este parâmetro para ativar ou desativar a coleção para aparecer no portal do Intune para atribuir políticas de segurança de ponto final no cenário anexar inquilino.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Id

Especifique o ID da coleção a configurar. Este valor é a propriedade CollectionID , por exemplo, XYZ00012.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetById
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InputObject

Especifique um objeto de coleção a configurar. Para obter este objeto, utilize os cmdlets Get-CMCollection, Get-CMDeviceCollection ou Get-CMUserCollection .

Propriedades do parâmetro

Tipo:IResultObject
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Coleção

Conjuntos de parâmetros

SetByValue
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifique o nome de uma coleção a configurar.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByName
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RemoveGroupName

Utilize este parâmetro para remover a sincronização com o grupo de Microsoft Entra especificado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TenantId

Especifique o ID do inquilino Microsoft Entra. Este valor é a propriedade TenantId , por exemplo, aaaabbbb-0000-cccc-1111-dddd2222eeee.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TenantName

Especifique o nome do inquilino Microsoft Entra, por exemplo, contoso.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TenantObject

Especifique um objeto para o inquilino Microsoft Entra. Para obter este objeto, utilize o cmdlet Get-CMAADTenant .

Propriedades do parâmetro

Tipo:IResultObject
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object