Add-CMSecurityScopeToAdministrativeUser
Add-CMSecurityScopeToAdministrativeUser
Adds a security scope to an administrative user or group in Configuration Manager.
Syntax
Parameter Set: AddScopeToAdminByName_Name
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserName <String> -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddScopeToAdminById_Id
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserId <Int32> -SecurityScopeId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddScopeToAdminById_Name
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserName <String> -SecurityScopeId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddScopeToAdminById_Object
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUser <IResultObject> -SecurityScopeId <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddScopeToAdminByName_Id
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserId <Int32> -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddScopeToAdminByName_Object
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUser <IResultObject> -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddScopeToAdminByObject_Id
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserId <Int32> -SecurityScope <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddScopeToAdminByObject_Name
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserName <String> -SecurityScope <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AddScopeToAdminByObject_Object
Add-CMSecurityScopeToAdministrativeUser -AdministrativeUser <IResultObject> -SecurityScope <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Add-CMSecurityScopeToAdministrativeUser cmdlet adds a security scope to an administrative user or administrative group in Microsoft System Center 2012 Configuration Manager.
For more information about security scopes, see the Configuring Security for Configuration Manager topic in the TechNet library at https://go.microsoft.com/fwlink/?LinkID=247225.
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.
Parameters
-AdministrativeUser<IResultObject>
Specifies an administrative user or administrative group object. To get an administrative user or administrative group object, use the Get-AdministrativeUser cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AdministrativeUserId<Int32>
Specifies an ID of an administrative user or administrative group.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AdministrativeUserName<String>
Specifies a name of an administrative user or administrative group.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SecurityScope<IResultObject>
Specifies a security scope object. To obtain a security scope object, use the Get-CMSecurityScope cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SecurityScopeId<String>
Specifies an ID of a security scope.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SecurityScopeName<String>
Specifies a name of a security scope.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Add a named security scope to a named administrative group
This command adds a security scope named Scope22 to an administrative group named Western Administrators.
PS C:\> Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserName "Western Administrators" -SecurityScopeName "Scope22"
Example 2: Add a security scope to an administrative group by using an ID
This command adds the security scope that has the ID SMS00067 to the administrative user that has the ID 345.
PS C:\> Add-CMSecurityScopeToAdministrativeUser -AdministrativeUserId 345 -SecurityScopeId "SMS00067"
Related topics
Add-CMDeviceCollectionToAdministrativeUser