Update-AzNetAppFilesBucket

Modulo:
Az.NetAppFiles Module

Aggiorna un bucket di Azure NetApp Files (ANF) esistente.

Sintassi

ByFieldsParameterSet (Impostazione predefinita) 

Update-AzNetAppFilesBucket
    -ResourceGroupName <String>
    -AccountName <String>
    -PoolName <String>
    -VolumeName <String>
    -Name <String>
    [-Permissions <String>]
    [-NfsUserId <Int64>]
    [-NfsGroupId <Int64>]
    [-CifsUserName <String>]
    [-ServerFqdn <String>]
    [-ServerCertificateObject <String>]
    [-OnCertificateConflictAction <String>]
    [-CertificateKeyVaultUri <String>]
    [-CertificateName <String>]
    [-CredentialsKeyVaultUri <String>]
    [-CredentialsSecretName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByParentObjectParameterSet 

Update-AzNetAppFilesBucket
    [-Name <String>]
    [-Permissions <String>]
    [-NfsUserId <Int64>]
    [-NfsGroupId <Int64>]
    [-CifsUserName <String>]
    [-ServerFqdn <String>]
    [-ServerCertificateObject <String>]
    [-OnCertificateConflictAction <String>]
    [-CertificateKeyVaultUri <String>]
    [-CertificateName <String>]
    [-CredentialsKeyVaultUri <String>]
    [-CredentialsSecretName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByResourceIdParameterSet 

Update-AzNetAppFilesBucket
    -ResourceId <String>
    [-Permissions <String>]
    [-NfsUserId <Int64>]
    [-NfsGroupId <Int64>]
    [-CifsUserName <String>]
    [-ServerFqdn <String>]
    [-ServerCertificateObject <String>]
    [-OnCertificateConflictAction <String>]
    [-CertificateKeyVaultUri <String>]
    [-CertificateName <String>]
    [-CredentialsKeyVaultUri <String>]
    [-CredentialsSecretName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByObjectParameterSet 

Update-AzNetAppFilesBucket
    -InputObject <PSNetAppFilesBucket>
    [-Permissions <String>]
    [-NfsUserId <Int64>]
    [-NfsGroupId <Int64>]
    [-CifsUserName <String>]
    [-ServerFqdn <String>]
    [-ServerCertificateObject <String>]
    [-OnCertificateConflictAction <String>]
    [-CertificateKeyVaultUri <String>]
    [-CertificateName <String>]
    [-CredentialsKeyVaultUri <String>]
    [-CredentialsSecretName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Update-AzNetAppFilesBucket applica patch a un bucket ANF esistente. Vengono modificate solo le proprietà fornite come parametri; tutti gli altri mantengono i valori correnti. Usare questo cmdlet per modificare le autorizzazioni, ruotare il certificato server (inline o tramite Azure Key Vault), cambiare l'identità utente del file system o eseguire la migrazione del bucket dalla gestione dei certificati inline alla gestione dei certificati gestiti da AKV.

Esempio

Esempio 1: Modificare le autorizzazioni del bucket e aggiornare il certificato inline

$newCertObject = [System.Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes((Get-Content -Raw ./bucket-new.pem)))

Update-AzNetAppFilesBucket -ResourceGroupName "MyRG" -AccountName "MyAnfAccount" -PoolName "MyAnfPool" -VolumeName "MyAnfVolume" -Name "MyAnfBucket" `
    -Permissions "ReadWrite" `
    -ServerCertificateObject $newCertObject `
    -OnCertificateConflictAction "Update"

Capovolge il bucket in ReadWrite e applica nuovamente il certificato del server usando il nuovo BLOB PEM.

Esempio 2: Eseguire la migrazione della gestione dei certificati a Azure Key Vault

Update-AzNetAppFilesBucket -ResourceGroupName "MyRG" -AccountName "MyAnfAccount" -PoolName "MyAnfPool" -VolumeName "MyAnfVolume" -Name "MyAnfBucket" `
    -CertificateKeyVaultUri "https://anf-bucket-certs.vault.azure.net/" -CertificateName "anf-bucket-cert" `
    -OnCertificateConflictAction "Update"

Passa il bucket per recuperare il certificato server da Azure Key Vault anziché usare un pem inline.

Parametri

-AccountName

Nome dell'account ANF

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByFieldsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CertificateKeyVaultUri

URI di base del Azure Key Vault usato per recuperare il certificato del server bucket.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CertificateName

Nome del certificato del server bucket archiviato in Azure Key Vault.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CifsUserName

Nome utente CIFS che accede ai dati del bucket (che si escludono a vicenda con NfsUserId/NfsGroupId).

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CredentialsKeyVaultUri

URI di base del Azure Key Vault usato per archiviare le credenziali del bucket.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CredentialsSecretName

Nome del segreto in Azure Key Vault che contiene le credenziali del bucket.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-InputObject

Oggetto bucket da aggiornare

Proprietà dei parametri

Tipo:PSNetAppFilesBucket
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByObjectParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Nome del bucket ANF

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:BucketName

Set di parametri

ByFieldsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NfsGroupId

GID utente NFS che accede ai dati del bucket.

Proprietà dei parametri

Tipo:

Nullable<T>[Int64]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NfsUserId

UID utente NFS che accede ai dati del bucket (che si escludono a vicenda con CifsUserName).

Proprietà dei parametri

Tipo:

Nullable<T>[Int64]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OnCertificateConflictAction

Azione quando si verifica un conflitto di certificati. Aggiornamento o esito negativo.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Permissions

Autorizzazioni di accesso per il bucket. ReadOnly o ReadWrite.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PoolName

Nome del pool di capacità ANF

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByFieldsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ResourceGroupName

Gruppo di risorse dell'account ANF

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByFieldsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ResourceId

ID risorsa del bucket ANF

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByResourceIdParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ServerCertificateObject

Contenuto con codifica Base64 del file PEM contenente il certificato del server bucket e la chiave privata.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ServerFqdn

Parte host dell'URL del bucket.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-VolumeName

Nome del volume ANF

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByFieldsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

PSNetAppFilesBucket

Output

PSNetAppFilesBucket