Import-CMSecurityRole

  • リファレンス
モジュール:
ConfigurationManager

XML ファイルからセキュリティ ロールをインポートします。

構文

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

説明

このコマンドレットを使用して、XML ファイルからセキュリティ ロールをインポートします。 XML は以前、Configuration Manager からエクスポートされています。 このエクスポート/インポート プロセスを使用して、カスタム セキュリティ ロールをバックアップしたり、別の階層間でコピーすることができます。

たとえば、ラボ環境でカスタム セキュリティ ロールを開発します。 この新しい役割をラボ階層からエクスポートし、それを実稼働階層にインポートします。

セキュリティ ロールとアクセス許可の詳細については、「Configuration Manager の役割ベースの管理の基本」 を参照してください。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: セキュリティ ロールのインポート

このコマンドは、 という名前の XML エクスポート ファイルから Configuration Manager にセキュリティ ロール ** をインポート **RemoteAdminSecurity.xml。 このコマンドは、インポートするセキュリティ ロールが、同じ名前の既存のセキュリティ ロールを上書きするかどうかを指定します。

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

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewRoleName

新しいセキュリティ ロールの名前を指定します。 指定した場合 -Overwrite $false 、この値は RoleName XML ファイル内のプロパティを上書きします。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Overwrite

同じ名前の $true 既存のセキュリティ ロールを上書きするには、このパラメーターを設定します。

Type:Boolean
Aliases:OverwrittenExisted
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-XmlFileName

セキュリティ ロールをインポートする XML ファイルのパスを指定します。 ローカル パスまたはネットワーク パスを指定できます。 ファイル拡張子 .xml を含めます。

Type:String
Aliases:FileName, FilePath, ImportFilePath, Path, RolesXml
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

入力

なし

出力

System.Object