Update-AzNetAppFilesBucket

Modul:
Az.NetAppFiles Module

Aktualisiert einen vorhandenen Azure NetApp Files(ANF)-Bucket.

Syntax

ByFieldsParameterSet (Standard) 

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

Beschreibung

Mit dem Cmdlet Update-AzNetAppFilesBucket wird ein vorhandener ANF-Bucket gepatcht. Nur die als Parameter bereitgestellten Eigenschaften werden geändert; alle anderen behalten ihre aktuellen Werte bei. Verwenden Sie dieses Cmdlet, um Berechtigungen zu ändern, das Serverzertifikat (inline oder über Azure Key Vault) zu drehen, die Dateisystembenutzeridentität zu wechseln oder den Bucket von der Inlinezertifikatverwaltung zur AKV-verwalteten Zertifikatverwaltung zu migrieren.

Beispiele

Beispiel 1: Ändern von Bucketberechtigungen und Aktualisieren des Inlinezertifikats

$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"

Flips the bucket to ReadWrite and re-applies the server certificate using the new PEM blob.

Beispiel 2: Migrieren der Zertifikatverwaltung zu 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"

Wechselt den Bucket, um sein Serverzertifikat aus Azure Key Vault abzurufen, anstatt ein Inline-PEM zu verwenden.

Parameter

-AccountName

Der Name des ANF-Kontos

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CertificateKeyVaultUri

Basis-URI des Azure Key Vault zum Abrufen des Bucketserverzertifikats verwendet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CertificateName

Name des Bucketserverzertifikats, das in Azure Key Vault gespeichert ist.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CifsUserName

CIFS-Benutzername, der auf die Bucketdaten zugreift (sich gegenseitig ausschließend mit NfsUserId/NfsGroupId).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CredentialsKeyVaultUri

Basis-URI der Azure Key Vault zum Speichern der Bucketanmeldeinformationen verwendet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CredentialsSecretName

Der Name des geheimen Schlüssels in Azure Key Vault, in dem die Bucketanmeldeinformationen vorhanden sind.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Das bucket-Objekt, das aktualisiert werden soll

Parametereigenschaften

Typ:PSNetAppFilesBucket
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByObjectParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Der Name des ANF-Buckets

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:BucketName

Parametersätze

ByFieldsParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NfsGroupId

NFS-Benutzer-GID, die auf die Bucketdaten zugreifen.

Parametereigenschaften

Typ:

Nullable<T>[Int64]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NfsUserId

NFS-Benutzer-UID, die auf die Bucketdaten zugreift (sich gegenseitig mit CifsUserName ausschließen).

Parametereigenschaften

Typ:

Nullable<T>[Int64]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnCertificateConflictAction

Aktion, wenn ein Zertifikatkonflikt auftritt. Aktualisieren oder fehlschlagen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Permissions

Zugriffsberechtigungen für den Bucket. Entweder ReadOnly oder ReadWrite.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PoolName

Der Name des ANF-Kapazitätspools

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Die Ressourcengruppe des ANF-Kontos

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceId

Die Ressourcen-ID des ANF-Buckets

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByResourceIdParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ServerCertificateObject

Base64-codierter Inhalt der PEM-Datei, die das Bucketserverzertifikat und den privaten Schlüssel enthält.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServerFqdn

Hostteil der Bucket-URL.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VolumeName

Der Name des ANF-Volumes

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

PSNetAppFilesBucket

Ausgaben

PSNetAppFilesBucket