Export-CMSecurityRole
セキュリティ ロールを XML ファイルにエクスポートします。
構文
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>]
説明
このコマンドレットを使用して、カスタム セキュリティ ロールの構成をサイトから XML ファイルにエクスポートします。 組み込みのロールをエクスポートすることはできません。 セキュリティ ロールとアクセス許可の詳細については、「 Configuration Manager でのロールベースの管理の基礎」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: カスタム セキュリティ ロールをエクスポートする
このコマンドは、XYZ00001 という名前 の カスタム セキュリティ ロールをSecurity_Manager.xmlという名前のファイル に エクスポートします。
Export-CMSecurityRole -Path "\\Contoso01\Export\Sec_Roles\Security_Manager.xml" -RoleId "XYZ00001"
パラメーター
-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 |
-InputObject
エクスポートするセキュリティ ロール オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMSecurityRole コマンドレットを 使用します。
型: | IResultObject |
Aliases: | Role |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Path
セキュリティ ロールをエクスポートする XML ファイルのパスを指定します。 ローカル パスまたはネットワーク パスを指定できます。
.xml
ファイル拡張子を含めます。
型: | String |
Aliases: | FileName, FilePath, ExportFilePath, XmlFileName, RolesXml |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RoleId
エクスポートするセキュリティ ロールの ID を指定します。 この値は、 RoleID
プロパティです。 このコマンドレットはカスタム ロールでのみ機能するため、この値は常にサイト コードで始まる必要があります。 (組み込みロールの ID は SMS
から始まります)。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RoleName
エクスポートするセキュリティ ロールの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object