Import-CMSecurityRole
從 XML 檔案匯入安全性角色。
語法
Import-CMSecurityRole
[-NewRoleName <String>]
-Overwrite <Boolean>
-XmlFileName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 從 XML 檔案匯入安全性角色。 XML 先前是從 Configuration Manager 導出。 您可以使用此匯出/匯入程式來備份自定義安全性角色,或在不同的階層之間複製它們。
例如,您會在實驗室環境中開發自定義安全性角色。 從實驗室階層導出這個新角色,然後將它匯入生產階層。
如需安全性角色和許可權的詳細資訊,請參閱 Configuration Manager 中以角色為基礎的系統管理基本概念。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請 參閱開始使用。
範例
範例 1:匯入安全性角色
此命令會從名為RemoteAdminSecurity.xml的 XML 匯出檔案,將安全性角色匯入 Configuration Manager 中。 命令指定您匯入的安全性角色會以相同的名稱覆寫現有的安全性角色。
Import-CMSecurityRole -XmlFileName "RemoteAdminSecurity.xml" -Overwrite $True
參數
-Confirm
執行 Cmdlet 之前提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-NewRoleName
指定新安全性角色的名稱。 如果您指定 -Overwrite $false
,這個值會覆寫 RoleName
XML 檔案中的 屬性。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Overwrite
將此參數設定為 $true
,以使用相同的名稱覆寫現有的安全性角色。
類型: | Boolean |
別名: | OverwrittenExisted |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-XmlFileName
指定要匯入安全性角色之 XML 檔案的路徑。 它可以是本機或網路路徑。
.xml
包含擴展名。
類型: | String |
別名: | FileName, FilePath, ImportFilePath, Path, RolesXml |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
None
輸出
System.Object