Import-CMSecurityRole
XML ファイルからセキュリティ ロールをインポートします。
構文
Import-CMSecurityRole
[-NewRoleName <String>]
-Overwrite <Boolean>
-XmlFileName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
XML ファイルからセキュリティ ロールをインポートするには、このコマンドレットを使用します。 XML は、以前に Configuration Manager からエクスポートされていました。 このエクスポート/インポート プロセスを使用して、カスタム セキュリティ ロールをバックアップしたり、別の階層間でコピーしたりできます。
たとえば、ラボ環境でカスタム セキュリティ ロールを開発します。 この新しいロールをラボ階層からエクスポートし、運用階層にインポートします。
セキュリティ ロールとアクセス許可の詳細については、「 Configuration Manager でのロールベースの管理の基礎」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: セキュリティ ロールをインポートする
このコマンドは、 という名前の XML エクスポート ファイルから Configuration Manager にセキュリティ ロール RemoteAdminSecurity.xmlインポートします。 コマンドは、インポートするセキュリティ ロールが同じ名前の既存のセキュリティ ロールを上書きすることを指定します。
Import-CMSecurityRole -XmlFileName "RemoteAdminSecurity.xml" -Overwrite $Trueパラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-NewRoleName
新しいセキュリティ ロールの名前を指定します。
-Overwrite $falseを指定した場合、この値は XML ファイル内の RoleName プロパティをオーバーライドします。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Overwrite
既存のセキュリティ ロールを同じ名前で上書きするには、このパラメーターを $true に設定します。
| 型: | Boolean |
| Aliases: | OverwrittenExisted |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-XmlFileName
セキュリティ ロールをインポートする XML ファイルのパスを指定します。 ローカル パスまたはネットワーク パスを指定できます。
.xmlファイル拡張子を含めます。
| 型: | String |
| Aliases: | FileName, FilePath, ImportFilePath, Path, RolesXml |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
System.Object