Share via

Import-CMUserDeviceAffinity

  • Referência
Módulo:
ConfigurationManager

Importa um arquivo que contém afinidades de usuário e dispositivo para Configuration Manager.

Syntax

Import-CMUserDeviceAffinity
      [-EnableColumnHeading <Boolean>]
      -FileName <String>
      [-MappingOrder <Mapping[]>]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Import-CMUserDeviceAffinity importa um arquivo que contém afinidades de usuário e dispositivo para Configuration Manager. A afinidade do dispositivo de usuário no Configuration Manager é um método de associação de um usuário a um ou mais dispositivos especificados.

Os dispositivos listados no arquivo que você especifica no parâmetro FileName já devem existir como recursos no banco de dados Configuration Manager. Se eles não existirem, a importação falhará.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: importar uma afinidade de dispositivo de usuário

PS XYZ:\>Import-CMUserDeviceAffinity -FileName "Remote_Users.csv" -EnableColumnHeadings $True

Esse comando importa a afinidade do dispositivo de usuário no arquivo chamado Remote_Users.csv. O parâmetro EnableColumnHeadings especifica que o arquivo de importação tem títulos de coluna para fins de referência.

Parâmetros

-Confirm

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

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-EnableColumnHeading

Type:Boolean
Aliases:EnableColumnHeadings
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileName

Especifica um arquivo .csv que contém uma lista de usuários e dispositivos entre os quais você deseja criar uma afinidade. Cada par de usuários e dispositivos deve estar em uma linha separada separada por uma vírgula. Use o formato <Domínio>\<nome de> usuário,< nome> netbios do dispositivo.

Type:String
Aliases:FilePath, ImportFilePath, Path
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-MappingOrder

Type:Mapping[]
Aliases:MappingOrders
Accepted values:Users, Devices, Ignored
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

Entradas

None

Saídas

System.Object