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