NAME

Update-DcsObjectImmutabilityExpiration

SYNOPSIS

Requests to update the expiration date of the specified immutable object.

SYNTAX

Update-DcsObjectImmutabilityExpiration [-ParentObject] <String> -RetentionPeriod <DateTime> [-Connection <String>] [-PipelineVariable <String>] [<CommonParameters>]

Update-DcsObjectImmutabilityExpiration [-Immutable] <String> -RetentionPeriod <DateTime> [-Connection <String>] [-PipelineVariable <String>] [<CommonParameters>]

DESCRIPTION

Requests to update the expiration date of the specified immutable object.

PARAMETERS

-ParentObject <String>

Name or ID of the parent object.

Required: true

Position: 1

Default value:

Accept pipeline input: true

Accept wildcard characters: false

-Immutable <String>

ID of the immutability object.

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

-RetentionPeriod <DateTime>

The date and time of the immutability retention period. One way to provide the RetentionPeriod parameter would be by piping a variable created by invoking New-Object with the TypeName parameter of DateTime with the correct arguments (see Help for New-Object, Get-Date). The RetentionPeriod parameter can also be provided in a string with the date and time. An example of the format to use is "Tuesday, March 29, 2011 2:51:00 PM".

Required: true

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-Connection <String>

Alias representing the connection to the server group. If not specified, the default connection will be used.

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

-PipelineVariable <String>

Required: false

Position: named

Default value:

Accept pipeline input: false

Accept wildcard characters: false

 

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (<http://go.microsoft.com/fwlink/?LinkID=113216).>

INPUTS

OUTPUTS

ImmutableDataObject that identifies the immutability.

NOTES

Also see Add-DcsObjectImmutability, Get-DcsObjectImmutability.

EXAMPLES

Update-DcsObjectImmutabilityExpiration -ParentObject "Virtual disk 1 @ 8/12/2025 10:58:05 AM UTC" -RetentionPeriod 2025.12.10