Copy-CMSecurityRole
カスタム セキュリティ ロールを作成します。
構文
Copy-CMSecurityRole
[-Description <String>]
-Name <String>
-SourceRoleId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Copy-CMSecurityRole
[-Description <String>]
-Name <String>
-SourceRoleName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Copy-CMSecurityRole
[-Description <String>]
-InputObject <IResultObject>
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
このコマンドレットを使用して、既存のセキュリティ ロールをテンプレートとして使用して新しいセキュリティ ロールを作成します。 Configuration Manager には、いくつかの組み込みのセキュリティ ロールが用意されています。 追加のセキュリティ ロールが必要な場合は、既存のセキュリティ ロールのコピーを作成し、そのコピーを変更することで、カスタム セキュリティ ロールを作成できます。
セキュリティ ロールとアクセス許可の詳細については、「 Configuration Manager でのロールベースの管理の基礎」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ID を使用してセキュリティ ロールをコピーする
このコマンドは、 SecRole02 という名前の新しいセキュリティ ロールを作成します。 ID SMS000CR ( ソフトウェア更新マネージャー ロール) を持つセキュリティ ロールがコピーされます。
Copy-CMSecurityRole -Name "SecRole02" -SourceRoleId "SMS000CR"パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
セキュリティ ロールの説明 (省略可能) を指定します。
| 型: | String |
| Aliases: | RoleDescription |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
コピーするセキュリティ ロール オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMSecurityRole コマンドレットを 使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
新しいセキュリティ ロールの名前を指定します。
| 型: | String |
| Aliases: | RoleName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SourceRoleId
コピーするセキュリティ ロールの ID を指定します。 この値は、OS Deployment Manager ロールのSMS000ARなど、RoleID プロパティです。
| 型: | String |
| Aliases: | CopiedFromId |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SourceRoleName
コピーするセキュリティ ロールの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object