Export (0) Print
Expand All
Expand Minimize

New-Tier

New-Tier

Creates a new tier connection.

Syntax

Parameter Set: Empty
New-Tier [-Name] <String> [-ManagementServerName] <String> [-Credential] <PSCredential> [[-Path] <String[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: FromRunAsAccount
New-Tier [-Name] <String> [-ManagementServerName] <String> [-RunAsAccount] <MonitoringSecureData> [-Credential] <PSCredential> [[-Path] <String[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

Creates a new tier connection.

Parameters

-Credential<PSCredential>

Specifies credentials under which to run the operation.


Aliases

none

Required?

true

Position?

4

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-ManagementServerName<String>

Specifies the name of the root management server.


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of the new tier.


Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Path<String[]>

Specifies the path, or paths, to the management groups for which to create the tier.


Aliases

none

Required?

false

Position?

5

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-RunAsAccount<MonitoringSecureData>

Specifies an account under which to run the command. You can use Get-RunAsAccount to retrieve an object to use as the value of this parameter.


Aliases

none

Required?

true

Position?

3

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


Required?

false

Position?

named

Default Value

none

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

Notes

  • For more information, type "Get-Help New-Tier -detailed". For technical information, type "Get-Help New-Tier -full".
    When specifying multiple values for a parameter, use commas to separate the values. For example, "<parameter-name> <value1>, <value2>".

Examples

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

This command uses Get-RunAsAccount to retrieve a run-as account and stores a reference to it in the $runas variable. It then creates a new tier by using New-Tier.


C:\PS>$runas = get-runasaccount |where-object {$_.username -eq 'testuser' -and $_.type -eq 'Windows'}$tier = new-tier -name 'Test Tier' `-managementservername 'fabrikam.contoso.net' `-runasaccount $runas

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft