Compartir a través de

Import-CMSecurityRole

  • Referencia
Módulo:
ConfigurationManager

Importar un rol de seguridad desde un archivo XML.

Sintaxis

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

Description

Use este cmdlet para importar un rol de seguridad desde un archivo XML. El XML se exportó anteriormente desde Configuration Manager. Puede usar este proceso de exportación e importación para realizar copias de seguridad de roles de seguridad personalizados o copiarlos entre jerarquías independientes.

Por ejemplo, desarrolla un rol de seguridad personalizado en un entorno de laboratorio. Exporte este nuevo rol desde la jerarquía de laboratorio y luego impórtelo en la jerarquía de producción.

Para obtener más información sobre los roles de seguridad y los permisos, consulte Aspectos básicos de la administración basada en roles en Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Importación de un rol de seguridad

Este comando importa un rol de seguridad a Configuration Manager desde el archivo de exportación XML denominado RemoteAdminSecurity.xml. El comando especifica que el rol de seguridad que se importa sobrescribe un rol de seguridad existente con el mismo nombre.

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

Parámetros

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NewRoleName

Especifique el nombre del nuevo rol de seguridad. Si especifica -Overwrite $false, este valor invalida la RoleName propiedad en el archivo XML.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Overwrite

Establezca este parámetro $true en para sobrescribir un rol de seguridad existente con el mismo nombre.

Tipo:Boolean
Alias:OverwrittenExisted
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-XmlFileName

Especifique la ruta de acceso del archivo XML para importar el rol de seguridad. Puede ser una ruta de acceso local o de red. Incluya la extensión de .xml archivo.

Tipo:String
Alias:FileName, FilePath, ImportFilePath, Path, RolesXml
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

System.Object