Condividi tramite


Import-CMSecurityRole

Importare un ruolo di sicurezza da un file XML.

Sintassi

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

Descrizione

Usare questo cmdlet per importare un ruolo di sicurezza da un file XML. Il codice XML è stato esportato in precedenza da Configuration Manager. È possibile usare questo processo di esportazione/importazione per eseguire il backup di ruoli di sicurezza personalizzati o copiarli tra gerarchie separate.

Ad esempio, si sviluppa un ruolo di sicurezza personalizzato in un ambiente lab. Esportare questo nuovo ruolo dalla gerarchia del lab e quindi importarlo nella gerarchia di produzione.

Per altre informazioni sui ruoli di sicurezza e sulle autorizzazioni, vedere Nozioni fondamentali sull'amministrazione basata su ruoli in Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Importare un ruolo di sicurezza

Questo comando importa un ruolo di sicurezza in Configuration Manager dal file di esportazione XML denominato RemoteAdminSecurity.xml. Il comando specifica che il ruolo di sicurezza importato sovrascrive un ruolo di sicurezza esistente con lo stesso nome.

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

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NewRoleName

Specificare il nome per il nuovo ruolo di sicurezza. Se si specifica -Overwrite $false, questo valore esegue l'override della RoleName proprietà nel file XML.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Overwrite

Impostare questo parametro su $true per sovrascrivere un ruolo di sicurezza esistente con lo stesso nome.

Tipo:Boolean
Alias:OverwrittenExisted
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-XmlFileName

Specificare il percorso del file XML per importare il ruolo di sicurezza. Può essere un percorso locale o di rete. Includere l'estensione del .xml file.

Tipo:String
Alias:FileName, FilePath, ImportFilePath, Path, RolesXml
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

System.Object