Share via


New-SCSPFStamp

Creates a stamp for a server or an instance of a System Center component.

Syntax

Default (Default)

New-SCSPFStamp
    -Name <String>
    [-DataCenter <DataCenter>]
    [-Tenants <Tenant[]>]
    [-Servers <Server[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The New-SCSPFStamp cmdlet creates a new stamp, which is a logical scale unit that specifies an instance of a System Center component running on a server. As tenants need additional capacity, additional stamps are provided.

Examples

Example 1: Create a stamp

PS C:\>New-SCSPFStamp -Name "ContosoStamp"

This command creates a stamp.

Example 2: Create a stamp for a DataCenter object

PS C:\>$DataCenterObject = New-Object Microsoft.SystemCenter.Foundation.SPFData.Types.DataCenter
PS C:\> $DataCenterObject.Name = "DataCenter_Contoso"
PS C:\> New-SCSPFStamp -Name "ContosoStamp" -DataCenter DataCenterObject

The first command gets a DataCenter object with the New-Object cmdlet with Microsoft.SystemCenter.Foundation.SPFData.Types.DataCenter specified as the value for TypeName.

The second command sets the Name property of the DataCenter object to the name of your data center.

The third command creates a stamp.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DataCenter

Specifies the name of a DataCenter object.

Parameter properties

Type:Microsoft.SystemCenter.Foundation.SPFData.Types.DataCenter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies a name for the stamp.

Parameter properties

Type:System.String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Servers

Specifies the name of one or more server objects to associate with the new stamp. To obtain a server, use the Get-SCSPFServer cmdlet.

Parameter properties

Type:

Microsoft.SystemCenter.Foundation.SPFData.Types.Server[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Tenants

Specifies the name of one or more tenant objects to associate with the new stamp. To obtain a tenant, use the Get-SCSPFTenant cmdlet.

Parameter properties

Type:

Microsoft.SystemCenter.Foundation.SPFData.Types.Tenant[]

Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

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

None

Outputs

System.Object