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 の役割ベースの管理の基本」 を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 1: ID を使用してセキュリティ ロールをコピーする
このコマンドは 、SecRole02 という名前の新しいセキュリティ ロールを作成します。 セキュリティ ロールを ID (ソフトウェア更新マネージャーの SMS000CR
役割 ) でコピー します。
Copy-CMSecurityRole -Name "SecRole02" -SourceRoleId "SMS000CR"
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
セキュリティ ロールのオプションの説明を指定します。
Type: | String |
Aliases: | RoleDescription |
Position: | Named |
Default value: | None |
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 |
-InputObject
コピーするセキュリティ 役割オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMSecurityRole コマンドレットを使用 します。
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
新しいセキュリティ ロールの名前を指定します。
Type: | String |
Aliases: | RoleName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceRoleId
コピーするセキュリティ ロールの ID を指定します。 この値は、OS Deployment Manager の役割など、 RoleID
SMS000AR
プロパティ です。
Type: | String |
Aliases: | CopiedFromId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SourceRoleName
コピーするセキュリティ ロールの名前を指定します。
Type: | String |
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 |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object