New-CrmInstanceResetRequestInfo
Creates the object that defines the parameters used to reset a Dataverse environment by using the Reset-CrmInstance cmdlet.
Syntax
New-CrmInstanceResetRequestInfo
-BaseLanguage <Int32>
-DomainName <String>
-TargetReleaseName <String>
-FriendlyName <String>
[-TemplateList <System.Collections.Generic.List`1[System.String]>]
[-Purpose <String>]
[-SecurityGroupId <Guid>]
[-PreferredCulture <Int32>]
[-CurrencyCode <String>]
[-CurrencyName <String>]
[-CurrencyPrecision <Int32>]
[-CurrencySymbol <String>]
[<CommonParameters>]
New-CrmInstanceResetRequestInfo
-CurrencyCode <String>
-CurrencyName <String>
-CurrencyPrecision <Int32>
-CurrencySymbol <String>
[<CommonParameters>]
Description
The New-CrmInstanceResetRequestInfo cmdlet creates the object that defines the parameters used to reset a Dataverse environment by using the Reset-CrmInstance cmdlet.
Examples
Example 1
PS C:\> $reqInfo = New-CrmInstanceResetRequestInfo -BaseLanguage 1033 -DomainName "contosodomain" -TargetReleaseName "Dynamics 365, version 9.0"-FriendlyName "Testing for Contoso Sales and Marketing" -TemplateList "" -Purpose "Testing app development" -SecurityGroupId <Guid> -CurrencyCode "USD" -CurrencyName "US DOLLAR" -CurrencyPrecision 2 -CurrencySymbol "$" -PreferredCulture $null
Defines the object that can be used to reset a sandbox environment to use Dynamics 365 for Customer Engagement, version 9.0 as the version, 1033 (US English) as the base language, and USD as the currency.
Parameters
-BaseLanguage
Required parameter. The base language for the environment. For a list of available languages, run the Get-CrmLanguages cmdlet.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CurrencyCode
Optional parameter. The currency region code to use for the environment. You can find a list of currency region codes by running the Get-CrmCurrencies cmdlet.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CurrencyName
Optional parameter. The currency name to use for the environment. You can find a list of currency names by running the Get-CrmCurrencies cmdlet.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CurrencyPrecision
Optional parameter. Set the pricing decimal precision. Valid values are 0-4.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CurrencySymbol
Optional parameter. Set the symbol that will represent the currency.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainName
Required parameter. Used for part of the domain namespace and appears in the application url. For example, if you use contoso as the DomainName, the url will appear similar to https://contoso.crm.dynamics.com.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FriendlyName
Required parameter. This is typically the name of your organization and is displayed in the Dataverse app.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PreferredCulture
Optional parameter. Provides information about a specific culture, also known as locale. The information includes the names for the culture, the writing system, the calendar used, the sort order of strings, and formatting for dates and numbers.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Purpose
Optional parameter. A description used to associate the environment with a specific intent. Only tenant administrators will see this description.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SecurityGroupId
Optional parameter. This value is used to determine the security group that includes the users who will have access to this environment.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TargetReleaseName
Required parameter. The version that will be used to re-provision the environment. Currently, only Dynamics 365, version 9.0 is supported.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TemplateList
Optional parameter. Specifies the apps you want provisioned in the environment. For a list of available template names, run the Get-CrmTemplates cmdlet.
Type: | System.Collections.Generic.List`1[System.String] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Inputs
System.Int32
System.String
System.Collections.Generic.List`1[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
System.Nullable`1[[System.Guid, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
System.Nullable`1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Outputs
System.Object