Import-CMSecurityRole

  • Referência
Módulo:
ConfigurationManager

Importar uma função de segurança de um ficheiro XML.

Sintaxe

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

Description

Utilize este cmdlet para importar uma função de segurança de um ficheiro XML. O XML foi exportado anteriormente do Configuration Manager. Pode utilizar este processo de exportação/importação para criar cópias de segurança de funções de segurança personalizadas ou copiá-las entre hierarquias separadas.

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

Para obter mais informações sobre funções e permissões de segurança, veja Noções básicas da administração baseada em funções no Configuration Manager.

Observação

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

Exemplos

Exemplo 1: Importar uma função de segurança

Este comando importa uma função de segurança para o Configuration Manager a partir do ficheiro de exportação XML com o nome RemoteAdminSecurity.xml. O comando especifica que a função de segurança que importar substitui uma função de segurança existente pelo mesmo nome.

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

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

Este parâmetro trata os carateres universais como valores de carateres literais. 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

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). 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

-NewRoleName

Especifique o nome da nova função de segurança. Se especificar -Overwrite $false, este valor substitui a RoleName propriedade no ficheiro XML.

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

-Overwrite

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

Tipo:Boolean
Aliases:OverwrittenExisted
Cargo:Named
Valor padrão:None
Obrigatório:True
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

-XmlFileName

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

Tipo:String
Aliases:FileName, FilePath, ImportFilePath, Path, RolesXml
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Object