Start-StarrRadarrMovieFileRename
SYNOPSIS
Starts renaming selected Radarr movie files.
SYNTAX
Named (Default)
Start-StarrRadarrMovieFileRename -MovieId <int> -MovieFileId <int[]> [-InstanceName <string>]
[-WhatIf] [-Confirm]
Explicit
Start-StarrRadarrMovieFileRename -Url <string> -ApiKey <string> -MovieId <int> -MovieFileId <int[]>
[-WhatIf] [-Confirm]
DESCRIPTION
This function starts renaming selected Radarr movie files. A successful response means Radarr accepted the command. It does not mean that every file was renamed. WhatIf prevents command submission.
EXAMPLES
EXAMPLE 1
EXAMPLE 2
Start-StarrRadarrMovieFileRename -Url 'http://localhost:7878' -ApiKey 'example-api-key' -MovieId 42 -MovieFileId 101 -WhatIf
PARAMETERS
-ApiKey
The API key used to authenticate with Radarr.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Explicit
Position: Named
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-InstanceName
The optional saved Radarr instance name. The matching instance is inferred when omitted.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Name
ParameterSets:
- Name: Named
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-MovieFileId
One or more positive Radarr movie-file identifiers to rename.
Type: System.Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-MovieId
The positive identifier of the Radarr movie that owns the files.
Type: System.Int32
DefaultValue: 0
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-Url
The absolute Radarr base URL.
Type: System.String
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: Explicit
Position: Named
IsRequired: true
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
-WhatIf
Runs the command in a mode that only reports what would happen without performing the actions.
Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
INPUTS
None.
You cannot pipe objects to this function.
OUTPUTS
PSStarr.Radarr.Command
This function returns the accepted Radarr command resource.
NOTES
RELATED LINKS
https://psstarr.xyz/command-reference/commands/Start-StarrRadarrMovieFileRename/