< Back
New-AzureRmResourceLock
Post
NAME New-AzureRmResourceLock
SYNOPSIS
Creates a resource lock.
SYNTAX
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockId <String> -LockLevel <LockLevel> [-LockNotes <String>] [-Pre] [-Confirm] [-WhatIf] [<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] -Scope <String> [-Confirm] [-WhatIf]
[<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] -ResourceGroupName <String> [-Confirm]
[-WhatIf] [<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] -ResourceGroupName <String> -ResourceName
<String> -ResourceType <String> [-Confirm] [-WhatIf] [<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] [-Confirm] [-WhatIf] [<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] -ResourceName <String> -ResourceType
<String> [-Confirm] [-WhatIf] [<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] -ResourceName <String> -ResourceType
<String> -TenantLevel [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The New-AzureRmResourceLock cmdlet creates a resource lock.
PARAMETERS
-ApiVersion <String>
Specifies the version of the resource provider API to use. If you do not specify a version, this cmdlet uses the latest available version.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces the command to run without asking for user confirmation.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-InformationAction <ActionPreference>
Specifies how this cmdlet responds to an information event.
The acceptable values for this parameter are:
- Continue
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-InformationVariable <String>
Specifies an information variable.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-LockId <String>
Specifies the ID of the lock.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-LockLevel <LockLevel>
Specifies the level for the lock. Currently, valid values are CanNotDelete, ReadOnly.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-LockName <String>
Specifies the name of the lock.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-LockNotes <String>
Specifies the notes for the lock.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Pre [<SwitchParameter>]
Indicates that this cmdlet considers pre-release API versions when it automatically determines which version to use.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-ResourceGroupName <String>
Specifies the name of a resource group for which the lock applies or that contains the resource group for which the lock applies.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ResourceName <String>
Specifies the name of the resource for which the lock applies. For instance, to specify a database, use the following format:
`ContosoServer/ContosoDatabase`
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ResourceType <String>
Specifies the resource type of the resource for which the lock applies.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Scope <String>
Specifies the scope to which the lock applies. For instance, to specify a database, use the following format:
`/subscriptions/`subscription ID`/resourceGroups/`resource group name`/providers/Microsoft.Sql/servers/`server name`/databases/`database name
To specify a resource group, use the following format:
`/subscriptions/`subscription ID`/resourceGroups/`resource group name
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-TenantLevel [<SwitchParameter>]
Indicates that this cmdlet operates at the tenant level.
Required? true
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
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, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
This cmdlet does not accept any input.
OUTPUTS
System.Management.Automation.PSObject
NOTES
Example 1: Create a resource lock on a website
PS C:\\>New-AzureRmResourceLock -LockLevel CanNotDelete -LockNotes "My lock notes" -LockName "ContosoSiteLock" -ResourceName "ContosoSite"
-ResourceType "microsoft.web/sites"
This command creates a resource lock on a website.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... sourcelock
Get-AzureRmResourceLock
Remove-AzureRmResourceLock
Set-AzureRmResourceLock
SYNOPSIS
Creates a resource lock.
SYNTAX
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockId <String> -LockLevel <LockLevel> [-LockNotes <String>] [-Pre] [-Confirm] [-WhatIf] [<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] -Scope <String> [-Confirm] [-WhatIf]
[<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] -ResourceGroupName <String> [-Confirm]
[-WhatIf] [<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] -ResourceGroupName <String> -ResourceName
<String> -ResourceType <String> [-Confirm] [-WhatIf] [<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] [-Confirm] [-WhatIf] [<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] -ResourceName <String> -ResourceType
<String> [-Confirm] [-WhatIf] [<CommonParameters>]
New-AzureRmResourceLock [-ApiVersion <String>] [-DefaultProfile <IAzureContextContainer>] [-Force] [-InformationAction <ActionPreference>]
[-InformationVariable <String>] -LockLevel <LockLevel> -LockName <String> [-LockNotes <String>] [-Pre] -ResourceName <String> -ResourceType
<String> -TenantLevel [-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
The New-AzureRmResourceLock cmdlet creates a resource lock.
PARAMETERS
-ApiVersion <String>
Specifies the version of the resource provider API to use. If you do not specify a version, this cmdlet uses the latest available version.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Force [<SwitchParameter>]
Forces the command to run without asking for user confirmation.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-InformationAction <ActionPreference>
Specifies how this cmdlet responds to an information event.
The acceptable values for this parameter are:
- Continue
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-InformationVariable <String>
Specifies an information variable.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-LockId <String>
Specifies the ID of the lock.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-LockLevel <LockLevel>
Specifies the level for the lock. Currently, valid values are CanNotDelete, ReadOnly.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-LockName <String>
Specifies the name of the lock.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-LockNotes <String>
Specifies the notes for the lock.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Pre [<SwitchParameter>]
Indicates that this cmdlet considers pre-release API versions when it automatically determines which version to use.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-ResourceGroupName <String>
Specifies the name of a resource group for which the lock applies or that contains the resource group for which the lock applies.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ResourceName <String>
Specifies the name of the resource for which the lock applies. For instance, to specify a database, use the following format:
`ContosoServer/ContosoDatabase`
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-ResourceType <String>
Specifies the resource type of the resource for which the lock applies.
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-Scope <String>
Specifies the scope to which the lock applies. For instance, to specify a database, use the following format:
`/subscriptions/`subscription ID`/resourceGroups/`resource group name`/providers/Microsoft.Sql/servers/`server name`/databases/`database name
To specify a resource group, use the following format:
`/subscriptions/`subscription ID`/resourceGroups/`resource group name
Required? true
Position? named
Default value None
Accept pipeline input? True (ByPropertyName)
Accept wildcard characters? false
-TenantLevel [<SwitchParameter>]
Indicates that this cmdlet operates at the tenant level.
Required? true
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
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, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
This cmdlet does not accept any input.
OUTPUTS
System.Management.Automation.PSObject
NOTES
Example 1: Create a resource lock on a website
PS C:\\>New-AzureRmResourceLock -LockLevel CanNotDelete -LockNotes "My lock notes" -LockName "ContosoSiteLock" -ResourceName "ContosoSite"
-ResourceType "microsoft.web/sites"
This command creates a resource lock on a website.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... sourcelock
Get-AzureRmResourceLock
Remove-AzureRmResourceLock
Set-AzureRmResourceLock