Set-CMCollectionCloudSync

  • Referência
Módulo:
ConfigurationManager

Configure a sincronização de associação de coleções para grupos do Microsoft Entra para uma coleção de dispositivos ou utilizadores. Para obter mais informações, consulte Como sincronizar membros da coleção com grupos do Microsoft Entra

Sintaxe

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>]
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>]
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 grupos do Microsoft Entra para um dispositivo ou coleção de utilizadores.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do 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 o grupo Microsoft Entra

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 do Microsoft Entra com o nome contoso e armazena-o na variável $AADTenant . O terceiro comando ativa a sincronização da coleção com o grupo Microsoft Entra com o nome 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 o grupo Microsoft Entra

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 o grupo Microsoft Entra com o nome 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

-AADGroupName

Especifique o nome do grupo microsoft Entra de destino com o qual os membros da coleção precisam de ser sincronizados.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

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

Tipo:IResultObject
Aliases:Collection
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveGroupName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TenantId

Especifique o ID do inquilino do Microsoft Entra. Este valor é a propriedade TenantId , por exemplo, 72f988bf-00ab-11cd-22ef-2d7cd011db00.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TenantName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TenantObject

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

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object