PowerShell.ws >_

The unOfficial PowerShell Website!

PowerShell Command Reference:
A short synopsis of New-ClientAccessArray: Use the New-ClientAccessArray cmdlet to create an object that represents a load balanced array of Client Access servers within a single Active Directory site.

A Description of New-ClientAccessArray:
You can create a load balanced array of Client Access server computers. The New-ClientAccessArray cmdlet creates an obj ect that represents this load balanced array. You can then manage that load balanced array as a single object. You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. T o see what permissions you need, see the "Client Access server array settings" entry in the Client Access Permissions t opic.

The Possible Inputs for New-ClientAccessArray:

The Correct Syntax for New-ClientAccessArray:
New-ClientAccessArray [-Name ] -Fqdn -Site [-Confirm []] [-DomainCo ntroller ] [-WhatIf []] []

The Return Values for New-ClientAccessArray:

Usage Examples for New-ClientAccessArray:

-------------------------- EXAMPLE 1 --------------------------




This example creates a new Client Access server array named server.contoso.com.

New-ClientAccessArray -FQDN server.contoso.com -Name "server.contoso.com"




-------------------------- EXAMPLE 2 --------------------------




This example creates a new Client Access server array in the China site.

New-ClientAccessArray -FQDN ClientArray.contoso.com -Site "China" -Name "clientarray.contoso.com"




-------------------------- EXAMPLE 3 --------------------------




This example creates a new Client Access server array after confirmation is given.

New-ClientAccessArray -FQDN server.contoso.com -Name "server.contoso.com" -Confirm $true








Possible Parameters for New-ClientAccessArray:


-Fqdn

The Fqdn parameter specifies the fully qualified domain name (FQDN) of the Client Access server array.



Required? true

Position? Named

Default value

Accept pipeline input? False

Accept wildcard characters? false



-Confirm []

The Confirm switch causes the command to pause processing and requires you to acknowledge what the command will

do before processing continues. You don't have to specify a value with the Confirm switch.



Required? false

Position? Named

Default value

Accept pipeline input? False

Accept wildcard characters? false



-DomainController

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that w

rites this configuration change to Active Directory.



Required? false

Position? Named

Default value

Accept pipeline input? False

Accept wildcard characters? false



-Name

The Name parameter specifies the name of the Client Access server array.



Required? false

Position? 1

Default value

Accept pipeline input? False

Accept wildcard characters? false



-Site

The Site parameter specifies the Active Directory site to which the Client Access server array belongs.



Required? true

Position? Named

Default value

Accept pipeline input? False

Accept wildcard characters? false



-WhatIf []

The WhatIf switch instructs the command to simulate the actions that it would take on the object. By using the

WhatIf switch, you can view what changes would occur without having to apply any of those changes. You don't ha

ve to specify a value with the WhatIf switch.



Required? false

Position? Named

Default value

Accept pipeline input? False

Accept wildcard characters? false





This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer and OutVariable. For more information, type,

"get-help about_commonparameters".