Add-CMSecurityScopeToAdministrativeUser

Adds a security scope to an administrative user or group in Configuration Manager.

Syntax

Add-CMSecurityScopeToAdministrativeUser
   -AdministrativeUser <IResultObject>
   [-Confirm]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -SecurityScopeId <String>
   [-WhatIf]
   [<CommonParameters>]
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUser  [-Confirm]
 [-DisableWildcardHandling] [-ForceWildcardHandling] -SecurityScopeName  [-WhatIf] []
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUser  [-Confirm]
 [-DisableWildcardHandling] [-ForceWildcardHandling] -SecurityScope  [-WhatIf]
 []
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserId  [-Confirm] [-DisableWildcardHandling]
 [-ForceWildcardHandling] -SecurityScopeId  [-WhatIf] []
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserId  [-Confirm] [-DisableWildcardHandling]
 [-ForceWildcardHandling] -SecurityScopeName  [-WhatIf] []
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserId  [-Confirm] [-DisableWildcardHandling]
 [-ForceWildcardHandling] -SecurityScope  [-WhatIf] []
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserName  [-Confirm] [-DisableWildcardHandling]
 [-ForceWildcardHandling] -SecurityScopeName  [-WhatIf] []
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserName  [-Confirm] [-DisableWildcardHandling]
 [-ForceWildcardHandling] -SecurityScopeId  [-WhatIf] []
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserName  [-Confirm] [-DisableWildcardHandling]
 [-ForceWildcardHandling] -SecurityScope  [-WhatIf] []

Description

The Add-CMSecurityScopeToAdministrativeUser cmdlet adds a security scope to an administrative user or administrative group in Microsoft System Center Configuration Manager.

For more information about security scopes, see Configuring Security for Configuration Manager on TechNet.

You can specify an administrative user or group by name or by ID or you can use the use the Get-CMAdministrativeUser cmdlet to obtain a user or group object. You can specify a security scope to add by name or by ID or you can use the Get-CMSecurityScope cmdlet to obtain a security scope.

Examples

Example 1: Add a named security scope to a named administrative group

PS C:\>Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserName "Western Administrators" -SecurityScopeName "Scope22"

This command adds a security scope named Scope22 to an administrative group named Western Administrators.

Example 2: Add a security scope to an administrative group by using an ID

PS C:\>Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserId 345 -SecurityScopeId "SMS00067"

This command adds the security scope that has the ID SMS00067 to the administrative user that has the ID 345.

Required Parameters

-AdministrativeUser

Specifies an administrative user or administrative group object. To get an administrative user or administrative group object, use the Get-CMAdministrativeUser cmdlet.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-AdministrativeUserId

Specifies an ID of an administrative user or administrative group.

Type:Int32
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AdministrativeUserName

Specifies a name of an administrative user or administrative group.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SecurityScope

Specifies a security scope object. To obtain a security scope object, use the Get-CMSecurityScope cmdlet.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-SecurityScopeId

Specifies the ID of a security scope.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SecurityScopeName

Specifies the name of a security scope. A security scope name can be Default or the name of a custom security scope.

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

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

Indicates that wildcard handling is disabled.

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

Indicates that wildcard handling is enabled.

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

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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