New-CMClientSetting

  • Referência
Módulo:
ConfigurationManager

Cria configurações de cliente personalizadas.

Syntax

New-CMClientSetting
   [-Description <String>]
   -Name <String>
   -Type <Types>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-CMClientSetting cria uma coleção de configurações personalizadas para computadores cliente do Configuration Manager. Depois de criar as configurações personalizadas e implantá-las em coleções de computadores cliente, as configurações personalizadas substituem as configurações padrão do cliente para essa coleção.

Para obter mais informações sobre as configurações do cliente, consulte About Client Configurações in Configuration Manager.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Criar uma coleção personalizada de configurações de cliente

PS XYZ:\> New-CMClientSetting -Name "Win08ClientSettings" -Description "Windows 8 Client Computers Settings" -Type 1
AgentConfigurations: {}
AssignmentCount:     0
CreatedBy:           Contoso\DChew
DateCreated:         8/04/2012 4:40:03 PM
DateModified:        8/04/2012 4:40:03 PM
Description:         Windows 8 Client Computers Settings
Enabled:             False
FeatureType:         1
Flags:               0
LastModifiedBy:      Contoso\DChew
Name:                Win08ClientSettings
Priority:            0
SecuredScopeNames:   {Default}
Settings ID:         16777220
Type:                1
UniqueID:            {0CCA6700-AE5E-4949-8FBC-AA6719775CC3}

Este comando cria configurações de dispositivo personalizadas para o grupo de computadores cliente que são executados Windows 8. Depois que a nova coleção de configurações é criada, o comando exibe uma lista não populada de propriedades de configuração. Para atualizar e exibir uma lista preenchida de propriedades, use Get-CMClientSetting. A saída para este exemplo mostra uma lista preenchida.

Parâmetros

-Confirm

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

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

-Description

Especifica uma descrição do conteúdo das novas configurações.

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
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). Não é possível combiná-lo com DisableWildcardHandling.

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

-Name

Especifica um nome para configurações de cliente personalizadas.

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

-Type

Especifica o tipo de configurações personalizadas. Os valores válidos são: 1 (dispositivo) ou 2 (usuário).

Type:Types
Accepted values:Default, Device, User
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Nenhum

Saídas

IResultObject