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