Add-CCSADComputerToSecurityGroup
Add-CCSADComputerToSecurityGroup
SYNOPSIS
Adds a computer to a security group in Active Directory using the CCS Web Service.
SYNTAX
__AllParameterSets
Add-CCSADComputerToSecurityGroup [-ComputerName] <string> [-SecurityGroupName] <string>
[[-DomainOUPath] <string>] [-Domain] <string> [-Url] <string> [-CCSCredential] <pscredential>
[[-DomainCredential] <pscredential>] [[-PasswordIsEncrypted] <bool>] [<CommonParameters>]
ALIASES
This cmdlet has the following aliases,
DESCRIPTION
Adds a computer to a security group in Active Directory using the CCS Web Service. This function requires the CCS Web Service URL and credentials to access it.
EXAMPLES
EXAMPLE 1
Add-CCSADComputerToSecurityGroup -ComputerName “TestPC” -SecurityGroupName “TestGroup” -DomainOUPath “OU=Computers,DC=example,DC=com” -Domain “example.com” -Url “https://example.com/CCSWebservice/CCS.asmx” -CCSCredential $Credential
EXAMPLE 2
Add-CCSADComputerToSecurityGroup -ComputerName “TestPC” -SecurityGroupName “TestGroup” -DomainOUPath “OU=Computers,DC=example,DC=com” -Domain “example.com” -Url “https://example.com/CCSWebservice/CCS.asmx” -CCSCredential $Credential -DomainCredential $DomainCredential
PARAMETERS
-CCSCredential
The credentials used to authenticate with the CCS Web Service.
Type: System.Management.Automation.PSCredential
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
Position: 5
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-ComputerName
The name of the computer to be added to the security group.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
Position: 0
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-Domain
The domain in which the computer resides.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
Position: 3
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-DomainCredential
The credentials of an account with permissions to add the computer to the security group, if not defined it will run in the CCSWebservice context.
Type: System.Management.Automation.PSCredential
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
Position: 6
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-DomainOUPath
The Organizational Unit (OU) path in which the computer resides.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
Position: 2
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-PasswordIsEncrypted
Indicates if the password in the DomainCredential is encrypted. Default is false.
Type: System.Boolean
DefaultValue: False
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
Position: 7
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-SecurityGroupName
The name of the security group to which the computer will be added.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
Position: 1
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-Url
The URL of the CCS Web Service. Example “https://example.com/CCSWebservice/CCS.asmx”.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
Position: 4
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.