Compartilhar via

Export-CMSecurityRole

  • Referência
Módulo:
ConfigurationManager

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

Sintaxe

Export-CMSecurityRole
      -InputObject <IResultObject>
      -Path <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-CMSecurityRole
      -Path <String>
      -RoleId <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-CMSecurityRole
      -Path <String>
      -RoleName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilize este cmdlet para exportar a configuração de uma função de segurança personalizada do site para um ficheiro XML. Não pode exportar funções incorporadas. 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: Exportar uma função de segurança personalizada

Este comando exporta a função de segurança personalizada com o nome XYZ00001 para o ficheiro com o nome Security_Manager.xml.

Export-CMSecurityRole -Path "\\Contoso01\Export\Sec_Roles\Security_Manager.xml" -RoleId "XYZ00001"

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

-InputObject

Especifique um objeto de função de segurança a exportar. Para obter este objeto, utilize o cmdlet Get-CMSecurityRole .

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

-Path

Especifique o caminho do ficheiro XML para exportar 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, ExportFilePath, XmlFileName, RolesXml
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RoleId

Especifique o ID da função de segurança a exportar. Este valor é a RoleID propriedade . Uma vez que este cmdlet só funciona com funções personalizadas, este valor deve começar sempre com o código do site. (Os IDs para funções incorporadas começam com SMS.)

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

-RoleName

Especifique o nome da função de segurança a exportar.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object