Share via


New-SCSPFOffer

New-SCSPFOffer

Creates an offer that specifies the stamps available to a tenant administrator user role.

Syntax

Parameter Set: Empty
New-SCSPFOffer -Name <String> [-Actions <String> ] [-Clouds <String> ] [-Networks <String> ] [-Stamps <Stamp[]> ] [-Templates <String> ] [-Tenants <Tenant[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The New-SCSPFOffer cmdlet defines stamps available to a tenant in Service Provider Foundation. Each tenant that is associated with the offer will have access to the stamps that are specified in the offer.

A tenant can be assigned only to a one offer. But an offer can associated with multiple tenants.

Parameters

-Actions<String>

To be disregarded. Service Provider Foundation does not use this parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Clouds<String>

To be disregarded. Service Provider Foundation does not use this parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String>

Specifies a name for the offer.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Networks<String>

To be disregarded. Service Provider Foundation does not use this parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Stamps<Stamp[]>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Templates<String>

To be disregarded. Service Provider Foundation does not use this parameter.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Tenants<Tenant[]>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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

Required?

false

Position?

named

Default Value

false

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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

1: Create an offer.

The first command gets a collection of tenants.

The second command gets a collection of stamps.

The third command creates a new offer associated with the tenants and stamps.

PS C:\> $tnnts = Get-SCSPFTenant | Where-Object {$_.Name –ne Administrator"}
PS C:\> $stamps = Get-SCSPFStamp
PS C:\> New-SCSPFOffer -Name "Enterprise" -Stamps $stamps -Tenants $tnnts

Get-SCSPFOffer

Set-SCSPFOffer

Remove-SCSPFOffer