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