Share via

Copy-CMSecurityRole

  • Referência
Módulo:
ConfigurationManager

Crie uma função de segurança personalizada.

Syntax

Copy-CMSecurityRole
    [-Description <String>]
    -Name <String>
    -SourceRoleId <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Copy-CMSecurityRole
    [-Description <String>]
    -Name <String>
    -SourceRoleName <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Copy-CMSecurityRole
    [-Description <String>]
    -InputObject <IResultObject>
    -Name <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Use este cmdlet para criar uma nova função de segurança usando uma função de segurança existente como modelo. O Configuration Manager fornece várias funções de segurança internas. Se você exigir funções de segurança adicionais, poderá criar uma função de segurança personalizada criando uma cópia de uma função de segurança existente e modificando a cópia.

Para obter mais informações sobre funções e permissões de segurança, consulte Fundamentos daadministração baseada em função no 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: copiar uma função de segurança usando uma ID

Este comando cria uma nova função de segurança chamada SecRole02. Copia a função de segurança com a ID SMS000CR , que é a função Gerenciador de Atualizações de Software.

Copy-CMSecurityRole -Name "SecRole02" -SourceRoleId "SMS000CR"

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

Especifique uma descrição opcional para a função de segurança.

Type:String
Aliases:RoleDescription
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

-InputObject

Especifique um objeto de função de segurança a ser copiado. Para obter esse objeto, use o cmdlet Get-CMSecurityRole.

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

-Name

Especifique um nome para a nova função de segurança.

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

-SourceRoleId

Especifique a ID da função de segurança a ser copiada. Esse valor é a RoleID propriedade, por SMS000AR exemplo, para a função gerenciador de implantação do sistema operacional.

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

-SourceRoleName

Especifique o nome da função de segurança a ser copiada.

Type:String
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object