Import-CMSecurityRole

  • Referência
Módulo:
ConfigurationManager

Importe uma função de segurança de um arquivo XML.

Syntax

Import-CMSecurityRole
      [-NewRoleName <String>]
      -Overwrite <Boolean>
      -XmlFileName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Use esse cmdlet para importar uma função de segurança de um arquivo XML. O XML foi exportado anteriormente de Configuration Manager. Você pode usar esse processo de exportação/importação para fazer backup de funções de segurança personalizadas ou copiá-las entre hierarquias separadas.

Por exemplo, você desenvolve uma função de segurança personalizada em um ambiente de laboratório. Exporte essa nova função da hierarquia de laboratório e importe-a para a hierarquia de produção.

Para obter mais informações sobre funções de segurança e permissões, consulte Fundamentos da administração baseada em função em Configuration Manager.

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 função de segurança

Esse comando importa uma função de segurança para Configuration Manager do arquivo de exportação XML chamado RemoteAdminSecurity.xml. O comando especifica que a função de segurança que você importa substitui uma função de segurança existente com o mesmo nome.

Import-CMSecurityRole -XmlFileName "RemoteAdminSecurity.xml" -Overwrite $True

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

-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

-NewRoleName

Especifique o nome da nova função de segurança. Se você especificar -Overwrite $false, esse valor substituirá a RoleName propriedade no arquivo XML.

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

-Overwrite

Defina esse parâmetro para $true substituir uma função de segurança existente com o mesmo nome.

Type:Boolean
Aliases:OverwrittenExisted
Position:Named
Default value:None
Required:True
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

-XmlFileName

Especifique o caminho do arquivo XML para importar a função de segurança. Pode ser um caminho local ou de rede. Inclua a extensão de .xml arquivo.

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

Entradas

None

Saídas

System.Object