Set-AzureRmStorageAccount

Modulo:

AzureRM.Storage

Modifica un account Archiviazione.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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>]

Descrizione

Il cmdlet Set-AzureRm Archiviazione Account modifica un account Archiviazione di Azure. È possibile usare questo cmdlet per modificare il tipo di account, aggiornare un dominio del cliente o impostare tag in un account di archiviazione.

Esempio

Esempio 1: Impostare il tipo di account Archiviazione

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

Questo comando imposta il tipo di account Archiviazione su Standard_RAGRS.

Esempio 2: Impostare un dominio personalizzato per un account Archiviazione

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

Questo comando imposta un dominio personalizzato per un account Archiviazione.

Esempio 3: Impostare il valore del livello di accesso

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

Il comando imposta il valore del livello di accesso come sporadico.

Esempio 4: Impostare il dominio personalizzato e i tag

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

Il comando imposta il dominio personalizzato e i tag per un account Archiviazione.

Esempio 5: Impostare Encryption KeySource su 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

Questo comando imposta Encryption KeySource con un nuovo insieme di credenziali delle chiavi creato.

Esempio 6: Impostare Encryption KeySource su "Microsoft. Archiviazione"

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

Questo comando imposta Encryption KeySource su "Microsoft. Archiviazione"

Esempio 7: Impostare la proprietà NetworkRuleSet di un account Archiviazione con 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"})

Questo comando imposta la proprietà NetworkRuleSet di un account Archiviazione con JSON

Esempio 8: Ottenere la proprietà NetworkRuleSet da un account Archiviazione e impostarla su un altro account Archiviazione

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

Questo primo comando ottiene la proprietà NetworkRuleSet da un account Archiviazione e il secondo comando lo imposta su un altro account Archiviazione

Esempio 9: Aggiornare un account Archiviazione con tipo "Archiviazione" o "BLOB Archiviazione" al tipo "Archiviazione V2" Archiviazione account

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

Il comando aggiorna un account Archiviazione con tipo "Archiviazione" o "BLOB Archiviazione" al tipo "Archiviazione V2" Archiviazione account.

Parametri

-AccessTier

Specifica il livello di accesso dell'account Archiviazione modificato da questo cmdlet. I valori accettabili per questo parametro sono: frequente e sporadico. Se si modifica il livello di accesso, potrebbe comportare addebiti aggiuntivi. Per altre informazioni, vedere Archiviazione BLOB di Azure: Livelli di archiviazione ad accesso frequente e ad accesso sporadico. Se l'account Archiviazione ha Kind come Archiviazione V2 o Blob Archiviazione, è possibile specificare il parametro AccessTier. Se l'account Archiviazione ha Kind come Archiviazione, non specificare il parametro AccessTier.

Type:	String
Accepted values:	Hot, Cool
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Eseguire il cmdlet in background

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AssignIdentity

Generare e assegnare una nuova identità dell'account Archiviazione per questo account Archiviazione da usare con i servizi di gestione delle chiavi come Azure KeyVault.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomDomainName

Specifica il nome del dominio personalizzato.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableHttpsTrafficOnly

Indica se l'account Archiviazione abilita solo il traffico HTTPS.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

Forza la modifica da scrivere nell'account Archiviazione.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyName

Se si usa -KeyvaultEncryption per abilitare la crittografia con Key Vault, specificare la proprietà Keyname con questa opzione.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyvaultEncryption

Indica se usare o meno Microsoft KeyVault per le chiavi di crittografia quando si usa la crittografia del servizio Archiviazione. Se KeyName, KeyVersion e KeyVaultUri sono tutti impostati, KeySource verrà impostato su Microsoft.Keyvault indipendentemente dal fatto che questo parametro sia impostato o meno.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyVaultUri

Quando si usa La crittografia dell'insieme di credenziali delle chiavi specificando il parametro -KeyvaultEncryption, usare questa opzione per specificare l'URI per Key Vault.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyVersion

Quando si usa La crittografia dell'insieme di credenziali delle chiavi specificando il parametro -KeyvaultEncryption, usare questa opzione per specificare l'URI per la versione della chiave.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Specifica il nome dell'account Archiviazione da modificare.

Type:	String
Aliases:	StorageAccountName, AccountName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NetworkRuleSet

NetworkRuleSet viene usato per definire un set di regole di configurazione per firewall e reti virtuali, nonché per impostare valori per le proprietà di rete, ad esempio i servizi autorizzati a ignorare le regole e come gestire le richieste che non corrispondono ad alcuna delle regole definite.

Type:	PSNetworkRuleSet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Specifica il nome del gruppo di risorse in cui modificare l'account Archiviazione.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SkuName

Specifica il nome SKU dell'account Archiviazione. I valori validi per questo parametro sono:

• Standard_LRS: archiviazione con ridondanza locale.
• Standard_ZRS- Archiviazione con ridondanza della zona.
• Standard_GRS: archiviazione con ridondanza geografica.
• Standard_RAGRS: archiviazione con ridondanza geografica dell'accesso in lettura.
• Premium_LRS- Archiviazione con ridondanza locale Premium. Non è possibile modificare Standard_ZRS e Premium_LRS tipi in altri tipi di account. Non è possibile modificare altri tipi di account in Standard_ZRS o Premium_LRS.

Type:	String
Aliases:	StorageAccountType, AccountType, Type
Accepted values:	Standard_LRS, Standard_ZRS, Standard_GRS, Standard_RAGRS, Premium_LRS
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageEncryption

Indica se impostare o meno la crittografia dell'account Archiviazione per l'uso di chiavi gestite da Microsoft.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Coppie chiave-valore sotto forma di tabella hash impostata come tag nel server. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}

Type:	Hashtable
Aliases:	Tags
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UpgradeToStorageV2

Aggiornare Archiviazione tipo di account da Archiviazione o BLOB Archiviazione a Archiviazione V2.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSubDomain

Indica se abilitare la convalida CName indiretta.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

String

Hashtable

Boolean

Output

PSStorageAccount

Collegamenti correlati

• Get-AzureRMStorageAccount
• New-AzureRmStorageAccount
• Remove-AzureRmStorageAccount