共用方式為

Copy-CMSecurityRole

  • 參考
模組:
ConfigurationManager

建立自訂安全性角色。

Syntax

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>]

Description

使用此 Cmdlet，利用現有的安全性角色做為範本，建立新的安全性角色。 Configuration Manager 提供數個內建的安全性角色。 如果您需要其他安全性角色，您可以建立現有安全性角色的複本，然後修改複本，以建立自訂安全性角色。

如需安全性角色和許可權的詳細資訊，請參閱 Configuration Manager 中角色型管理的基礎。

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。

範例

範例1：使用識別碼複製安全性角色

這個命令會建立名為 SecRole02的新安全性角色。 它會複製具有識別碼的安全性角色 SMS000CR ，也就是 軟體更新管理員 角色。

Copy-CMSecurityRole -Name "SecRole02" -SourceRoleId "SMS000CR"

參數

-Confirm

執行 Cmdlet 之前提示您確認。

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

指定要複製的安全性角色物件。 若要取得此物件，請使用 CMSecurityRole Cmdlet。

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-SourceRoleId

指定要複製之安全性角色的識別碼。 此值是 RoleID 屬性，例如 SMS000AR OS 部署管理員 角色。

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

顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。

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

-名稱

指定新安全性角色的名稱。

Type:String
Aliases:RoleName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

輸入

ConfigurationManagement IResultObject

輸出

系統.物件