external help file	Module Name	online version	schema
Intersight.PowerShell.dll-Help.xml	Intersight.PowerShell		2.0.0

New-IntersightAssetDeviceContractNotification

SYNOPSIS

Fill in the Synopsis

SYNTAX


New-IntersightAssetDeviceContractNotification [-AdditionalProperties< System.Collections.Generic.Dictionary`2[string,object]>][-Contract< AssetContractInformation>][-ContractStatus< AssetDeviceContractNotification.ContractStatusEnum>][-ContractStatusReason< AssetDeviceContractNotification.ContractStatusReasonEnum>][-ContractUpdatedTime< DateTime>][-CoveredProductLineEndDate< string>][-DeviceId< string>][-EndCustomer< AssetCustomerInformation>][-EndUserGlobalUltimate< AssetGlobalUltimate>][-IsValid< bool>][-ItemType< string>][-LastDateOfSupport< DateTime>][-MaintenancePurchaseOrderNumber< string>][-MaintenanceSalesOrderNumber< string>][-Moid< string>][-Product< AssetProductInformation>][-PurchaseOrderNumber< string>][-ResellerGlobalUltimate< AssetGlobalUltimate>][-SalesOrderNumber< string>][-ServiceDescription< string>][-ServiceEndDate< DateTime>][-ServiceLevel< string>][-ServiceSku< string>][-ServiceStartDate< DateTime>][-StateContract< AssetDeviceContractNotification.StateContractEnum>][-StateSn2Info< AssetDeviceContractNotification.StateSn2InfoEnum>][-Tags< System.Collections.Generic.List`1[MoTag]>][-WarrantyEndDate< string>][-WarrantyType< string>][-IfMatch< String>][-IfNoneMatch< String>][-Json< SwitchParameter>][-WithHttpInfo< SwitchParameter>]

DESCRIPTION

Create a 'AssetDeviceContractNotification' resource.

PARAMETERS

-AdditionalProperties

Type: System.Collections.Generic.Dictionary`2[string,object]
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-Contract

Contract information for the Cisco support contract purchased for the Cisco device.

Note :- Use Initialize-IntersightAssetContractInformation to create the object of complex type AssetContractInformation

Type: AssetContractInformation
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-ContractStatus

Calculated contract status that is derived based on the service line status and contract end date. It is different from serviceLineStatus property. serviceLineStatus gives us ACTIVE, OVERDUE, EXPIRED. These are transformed into Active, Expiring Soon and Not Covered.\n* Unknown - The device's contract status cannot be determined.\n* Not Covered - The Cisco device does not have a valid support contract.\n* Active - The Cisco device is covered under a active support contract.\n* Expiring Soon - The contract for this Cisco device is going to expire in the next 30 days.

Type: AssetDeviceContractNotification.ContractStatusEnum
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-ContractStatusReason

Reason for contract status. In case of Not Covered, reason is either Terminated or Expired.\n* `` - There is no reason for the specified contract status.\n* Line Item Expired - The Cisco device does not have a valid support contract, it has expired.\n* `Line Item Terminated` - The Cisco device does not have a valid support contract, it has been terminated.

Type: AssetDeviceContractNotification.ContractStatusReasonEnum
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-ContractUpdatedTime

Date and time indicating when the contract data is last refreshed.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-CoveredProductLineEndDate

End date of the covered product line. The coverage end date is fetched from Cisco SN2INFO API.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-DeviceId

Unique identifier of the Cisco device.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-EndCustomer

End customer information for the Cisco support contract purchased for the Cisco device.

Note :- Use Initialize-IntersightAssetCustomerInformation to create the object of complex type AssetCustomerInformation

Type: AssetCustomerInformation
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-EndUserGlobalUltimate

EndUserGlobalUltimate information listed in the contract.

Note :- Use Initialize-IntersightAssetGlobalUltimate to create the object of complex type AssetGlobalUltimate

Type: AssetGlobalUltimate
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-IsValid

Validates if the device is a genuine Cisco device. Validated is done using the Cisco SN2INFO APIs.

Type: bool
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-ItemType

Item type of this specific Cisco device. example "Chassis".

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-LastDateOfSupport

The last date of hardware support for this device.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-MaintenancePurchaseOrderNumber

Maintenance purchase order number for the Cisco device.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-MaintenanceSalesOrderNumber

Maintenance sales order number for the Cisco device.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-Moid

The unique identifier of this Managed Object instance.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-Product

Product information of the offering under a contract.

Note :- Use Initialize-IntersightAssetProductInformation to create the object of complex type AssetProductInformation

Type: AssetProductInformation
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-PurchaseOrderNumber

Purchase order number for the Cisco device. It is a unique number assigned for every purchase.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-ResellerGlobalUltimate

ResellerGlobalUltimate information listed in the contract.

Note :- Use Initialize-IntersightAssetGlobalUltimate to create the object of complex type AssetGlobalUltimate

Type: AssetGlobalUltimate
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-SalesOrderNumber

Sales order number for the Cisco device. It is a unique number assigned for every sale.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-ServiceDescription

The type of service contract that covers the Cisco device.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-ServiceEndDate

End date for the Cisco service contract that covers this Cisco device.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-ServiceLevel

The type of service contract that covers the Cisco device.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-ServiceSku

The SKU of the service contract that covers the Cisco device.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-ServiceStartDate

Start date for the Cisco service contract that covers this Cisco device.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-StateContract

Internal property used for triggering and tracking actions for contract information.\n* Update - Sn2Info/Contract information needs to be updated.\n* OK - Sn2Info/Contract information was fetched succcessfuly and updated.\n* Failed - Sn2Info/Contract information was not available or failed while fetching.\n* Retry - Sn2Info/Contract information update failed and will be retried later.

Type: AssetDeviceContractNotification.StateContractEnum
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-StateSn2Info

Internal property used for triggering and tracking actions for sn2info information.\n* Update - Sn2Info/Contract information needs to be updated.\n* OK - Sn2Info/Contract information was fetched succcessfuly and updated.\n* Failed - Sn2Info/Contract information was not available or failed while fetching.\n* Retry - Sn2Info/Contract information update failed and will be retried later.

Type: AssetDeviceContractNotification.StateSn2InfoEnum
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-Tags

Note :- Use Initialize-IntersightMoTag to create the object of complex type MoTag

Type: System.Collections.Generic.List`1[MoTag]
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-WarrantyEndDate

End date for the warranty that covers the Cisco device.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-WarrantyType

Type of warranty that covers the Cisco device.

Type: string
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True True (ByPropertyName)
Accept wildcard characters: False

-IfMatch

For methods that apply server-side changes, and in particular for PUT, If-Match can be used to prevent the lost update problem. It can check if the modification of a resource that the user wants to upload will not override another change that has been done since the original resource was fetched. If the request cannot be fulfilled, the 412 (Precondition Failed) response is returned. When modifying a resource using POST or PUT, the If-Match header must be set to the value of the resource ModTime property after which no lost update problem should occur. For example, a client send a GET request to obtain a resource, which includes the ModTime property. The ModTime indicates the last time the resource was created or modified. The client then sends a POST or PUT request with the If-Match header set to the ModTime property of the resource as obtained in the GET request.

Type: String
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True False
Accept wildcard characters: False

-IfNoneMatch

For methods that apply server-side changes, If-None-Match used with the * value can be used to create a resource not known to exist, guaranteeing that another resource creation didn't happen before, losing the data of the previous put. The request will be processed only if the eventually existing resource's ETag doesn't match any of the values listed. Otherwise, the status code 412 (Precondition Failed) is used. The asterisk is a special value representing any resource. It is only useful when creating a resource, usually with PUT, to check if another resource with the identity has already been created before. The comparison with the stored ETag uses the weak comparison algorithm, meaning two resources are considered identical if the content is equivalent - they don't have to be identical byte for byte.

Type: String
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True False
Accept wildcard characters: False

-Json

Returns the json payload received in response.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True False
Accept wildcard characters: False

-WithHttpInfo

Returns the HTTP response with headers and content.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: false
Position: Named
Default value: None
Accept pipeline input: True False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

EXAMPLES

Example 1

PS C:\> New-IntersightAssetDeviceContractNotification

FilesExpand file tree

New-IntersightAssetDeviceContractNotification.md

Latest commit

History