Creates a column object representing a decimal
data type.
New-DecimalColumn [-Name] <String> [[-Precision] <Int32>] [[-Scale] <Int32>] [-Sparse] [-Default <String>] [-Description <String>] [<CommonParameters>]
New-DecimalColumn [-Name] <String> [[-Precision] <Int32>] [[-Scale] <Int32>] -Identity [-Seed <Int32>] [-Increment <Int32>] [-NotForReplication] [-Default <String>] [-Description <String>] [<CommonParameters>]
New-DecimalColumn [-Name] <String> [[-Precision] <Int32>] [[-Scale] <Int32>] -NotNull [-Default <String>] [-Description <String>] [<CommonParameters>]
Use this function in the Column
script block for Add-Table
:
Add-Table 'Items' {
Decimal 'Price'
}
Name | Type | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|---|
Name | String | The column's name. |
true | false | |
Precision | Int32 | Maximum total number of decimal digits that will be stored. |
false | false | 0 |
Scale | Int32 | The number of decimal digits that will be stored to the right of the decimal point. |
false | false | 0 |
Identity | SwitchParameter | The column should be an identity. |
true | false | False |
Seed | Int32 | The starting value for the identity. |
false | false | 0 |
Increment | Int32 | The increment between auto-generated identity values. |
false | false | 0 |
NotForReplication | SwitchParameter | Stops the identity from being replicated. |
false | false | False |
NotNull | SwitchParameter | Don't allow |
true | false | False |
Sparse | SwitchParameter | Store nulls as Sparse. |
false | false | False |
Default | String | A SQL Server expression for the column's default value |
false | false | |
Description | String | A description of the column. |
false | false |
Add-Table 'Items' { Decimal 'Price' 5 2 }
Demonstrates how to create an optional decimal
column called Price
, with a five-digit precision (prices less than $999.99) and a scale of 2 (2 digits after the decimal
).
Add-Table 'Items' { Decimal 'Price' -Identity -Seed 1 -Increment 1 }
Demonstrates how to create a required decimal
column called Price
, which is used as the table's identity. The identity values will start at 1, and increment by 1. Uses SQL Server's default precision/scale.
Add-Table 'Items' { Decimal 'Price' -NotNull }
Demonstrates how to create a required decimal
column called Price
. Uses SQL Server's default precision/scale.
Add-Table 'Items' { Decimal 'Price' -Sparse }
Demonstrates how to create a sparse, optional decimal
column called Price
. Uses SQL Server's default precision/scale.
Add-Table 'Items' { Decimal 'Price' -NotNull -Default '0' }
Demonstrates how to create a required decimal
column called Price
with a default value of 0
. Uses SQL Server's default precision/scale.
Add-Table 'Items' { Decimal 'Price' -NotNull -Description 'The price of the item.' }
Demonstrates how to create a required decimal
column with a description. Uses SQL Server's default precision/scale.