Sdílet prostřednictvím

Set-AzureRmStorageAccount

  • Reference
Modul:
AzureRM.Storage

Upraví účet úložiště.

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

Set-AzureRmStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-StorageEncryption]
   [-AssignIdentity]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureRmStorageAccount
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Force]
   [-SkuName <String>]
   [-AccessTier <String>]
   [-CustomDomainName <String>]
   [-UseSubDomain <Boolean>]
   [-Tag <Hashtable>]
   [-EnableHttpsTrafficOnly <Boolean>]
   [-KeyvaultEncryption]
   -KeyName <String>
   -KeyVersion <String>
   -KeyVaultUri <String>
   [-AssignIdentity]
   [-NetworkRuleSet <PSNetworkRuleSet>]
   [-UpgradeToStorageV2]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Set-AzureRmStorageAccount upravuje účet služby Azure Storage. Pomocí této rutiny můžete upravit typ účtu, aktualizovat doménu zákazníka nebo nastavit značky v účtu úložiště.

Příklady

Příklad 1: Nastavení typu účtu úložiště

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -Type "Standard_RAGRS"

Tento příkaz nastaví typ účtu úložiště na Standard_RAGRS.

Příklad 2: Nastavení vlastní domény pro účet úložiště

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -CustomDomainName "www.contoso.com" -UseSubDomain $True

Tento příkaz nastaví vlastní doménu pro účet úložiště.

Příklad 3: Nastavení hodnoty úrovně přístupu

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -AccessTier Cool

Příkaz nastaví hodnotu úrovně přístupu tak, aby byla studená.

Příklad 4: Nastavení vlastní domény a značek

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -CustomDomainName "www.domainname.com" -UseSubDomain $true -Tag @{tag0="value0";tag1="value1";tag2="value2"}

Příkaz nastaví vlastní doménu a značky pro účet úložiště.

Příklad 5: Nastavení šifrovacího zdroje klíčů na keyvault

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -AssignIdentity
PS C:\>$account = Get-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount"

PS C:\>$keyVault = New-AzureRmKeyVault -VaultName "MyKeyVault" -ResourceGroupName "MyResourceGroup" -Location "EastUS2"
PS C:\>$key = Add-AzureKeyVaultKey -VaultName "MyKeyVault" -Name "MyKey" -Destination 'Software'
PS C:\>Set-AzureRmKeyVaultAccessPolicy -VaultName "MyKeyVault" -ObjectId $account.Identity.PrincipalId -PermissionsToKeys wrapkey,unwrapkey,get

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -KeyvaultEncryption -KeyName $key.Name -KeyVersion $key.Version -KeyVaultUri $keyVault.VaultUri

Tento příkaz nastavil šifrovací zdroj klíčů s novou vytvořenou službou Keyvault.

Příklad 6: Nastavení šifrovacího zdroje klíčů na Microsoft.Storage

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -StorageEncryption

Tento příkaz nastavil šifrovací zdroj klíčů na Microsoft.Storage.

Příklad 7: Nastavení vlastnosti NetworkRuleSet účtu úložiště s JSON

PS C:\>Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -NetworkRuleSet (@{bypass="Logging,Metrics";
    ipRules=(@{IPAddressOrRange="20.11.0.0/16";Action="allow"},
            @{IPAddressOrRange="10.0.0.0/7";Action="allow"});
    virtualNetworkRules=(@{VirtualNetworkResourceId="/subscriptions/s1/resourceGroups/g1/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1";Action="allow"},
                        @{VirtualNetworkResourceId="/subscriptions/s1/resourceGroups/g1/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2";Action="allow"});
    defaultAction="allow"})

Tento příkaz nastaví vlastnost NetworkRuleSet účtu úložiště s JSON.

Příklad 8: Získání vlastnosti NetworkRuleSet z účtu úložiště a jeho nastavení na jiný účet úložiště

PS C:\> $networkRuleSet = (Get-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount").NetworkRuleSet 
PS C:\> Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount2" -NetworkRuleSet $networkRuleSet

Tento první příkaz získá vlastnost NetworkRuleSet z účtu úložiště a druhý příkaz ji nastaví na jiný účet úložiště.

Příklad 9: Upgrade účtu úložiště s druhem "Storage" nebo "BlobStorage" na účet úložiště typu StorageV2

PS C:\> Set-AzureRmStorageAccount -ResourceGroupName "MyResourceGroup" -AccountName "mystorageaccount" -UpgradeToStorageV2

Příkaz upgraduje účet úložiště s druhem "Storage" nebo "BlobStorage" na typ StorageV2.

Parametry

-AccessTier

Určuje úroveň přístupu účtu úložiště, kterou tato rutina upraví. Přijatelné hodnoty pro tento parametr jsou: Horká a Studená. Pokud změníte úroveň přístupu, může to mít za následek další poplatky. Další informace najdete v tématu Azure Blob Storage: Horká a studená úroveň úložiště. Pokud má účet úložiště kind jako StorageV2 nebo BlobStorage, můžete zadat parametr AccessTier . Pokud má účet Storage hodnotu Kind jako Storage, nezadávejte parametr AccessTier .

Typ:String
Přípustné hodnoty:Hot, Cool
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AsJob

Spuštění rutiny na pozadí

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AssignIdentity

Vygenerujte a přiřaďte pro tento účet úložiště novou identitu účtu úložiště pro použití se službami pro správu klíčů, jako je Azure KeyVault.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CustomDomainName

Určuje název vlastní domény.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EnableHttpsTrafficOnly

Určuje, jestli účet úložiště povoluje pouze provoz HTTPS.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Force

Vynutí zápis změny do účtu úložiště.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-KeyName

Pokud k povolení šifrování ve službě Key Vault používáte -KeyvaultEncryption, zadejte vlastnost Keyname s touto možností.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-KeyvaultEncryption

Určuje, jestli se má při použití šifrování služby Storage použít microsoft KeyVault pro šifrovací klíče. Pokud jsou všechny klíče KeyName, KeyVersion a KeyVaultUri nastavené, bude KeySource nastaven na Microsoft.Keyvault bez ohledu na to, jestli je tento parametr nastavený, nebo ne.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-KeyVaultUri

Při použití šifrování služby Key Vault zadáním parametru -KeyvaultEncryption použijte tuto možnost k zadání identifikátoru URI služby Key Vault.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-KeyVersion

Při použití šifrování služby Key Vault zadáním parametru -KeyvaultEncryption použijte tuto možnost k určení identifikátoru URI pro verzi klíče.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název účtu úložiště, který chcete upravit.

Typ:String
Aliasy:StorageAccountName, AccountName
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-NetworkRuleSet

NetworkRuleSet se používá k definování sady konfiguračních pravidel pro brány firewall a virtuální sítě a také k nastavení hodnot pro vlastnosti sítě, jako jsou služby povolené obejít pravidla a jak zpracovávat požadavky, které neodpovídají žádnému z definovaných pravidel.

Typ:PSNetworkRuleSet
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje název skupiny prostředků, ve které chcete upravit účet úložiště.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SkuName

Určuje název skladové položky účtu úložiště. Tento parametr přijímá tyto hodnoty:

  • Standard_LRS – místně redundantní úložiště.
  • Standard_ZRS – zónově redundantní úložiště.
  • Standard_GRS – geograficky redundantní úložiště.
  • Standard_RAGRS – geograficky redundantní úložiště s přístupem pro čtení
  • Premium_LRS – místně redundantní úložiště Úrovně Premium. Typy Standard_ZRS a Premium_LRS nemůžete změnit na jiné typy účtů. Jiné typy účtů nemůžete změnit na Standard_ZRS ani Premium_LRS.
Typ:String
Aliasy:StorageAccountType, AccountType, Type
Přípustné hodnoty:Standard_LRS, Standard_ZRS, Standard_GRS, Standard_RAGRS, Premium_LRS
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-StorageEncryption

Určuje, jestli chcete nastavit šifrování účtu úložiště tak, aby používaly klíče spravované Microsoftem.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Tag

Páry klíč-hodnota ve formě tabulky hash nastavené jako značky na serveru. Příklad: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Aliasy:Tags
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-UpgradeToStorageV2

Upgradujte druh účtu úložiště ze služby Storage nebo BlobStorage na StorageV2.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-UseSubDomain

Určuje, jestli se má povolit nepřímé ověřování CName.

Typ:Nullable<T>[Boolean]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Hashtable

Boolean

Výstupy

PSStorageAccount