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.

INPUTS

OUTPUTS

NOTES