Compartilhar via

Copy-CMConfigurationPolicy

  • Referência
Módulo:
ConfigurationManager

Copia uma política de configuração.

Sintaxe

Copy-CMConfigurationPolicy
    [-InputObject] <IResultObject>
    [-NewName] <String>
    [-PassThru]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Copy-CMConfigurationPolicy
    [-Id] <Int32>
    [-NewName] <String>
    [-PassThru]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Copy-CMConfigurationPolicy
    [-Name] <String>
    [-NewName] <String>
    [-PassThru]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O Copy-CMConfigurationPolicy copia uma política de configuração. Uma política de configuração pode ser um item de configuração de perfil de certificado de autenticação do cliente, um item de configuração de perfil sem fio ou outros. Consulte a seção Alias para obter itens de política adicionais que você pode usar este cmdlet para copiar.

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: copiar uma política de configuração usando o pipeline

PS XYZ:\> Get-CMConfigurationPolicy -Name "TrustedCACert01" -Fast | Copy-CMConfigurationPolicy -NewName "TrustedCACert01_copy"

Esse comando obtém o objeto de política de configuração chamado TrustedCACert01 e usa o operador de pipeline para passar o objeto para Copy-CMConfiguratinPolicy, que cria uma cópia da política e nomeia-o TrustedCACert01_copy.

Exemplo 2: copiar uma política de configuração por ID

PS XYZ:\> Copy-CMConfigurationPolicy -Id 16777454 -NewName "EmailProfile1_copy"

Esse comando faz uma cópia da política de configuração com a ID de 16777454 e nomeia-a EmailProfile1_copy.

Parâmetros

-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

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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

-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.

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

-Id

Especifica o CI_ID de uma política de configuração.

Tipo:Int32
Aliases:CIId, CI_ID
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Obtém um objeto de política de configuração. Para obter um objeto de política de configuração, use o cmdlet Get-CMConfigurationPolicy.

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

-Name

Especifica o nome de uma política de configuração.

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

-NewName

Especifica um nome para a cópia da política de configuração.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
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