New-AzConnectedMachineExtension
Opération de création de l’extension.
Syntax
New-AzConnectedMachineExtension
-MachineName <String>
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-Location <String>
[-AutoUpgradeMinorVersion]
[-EnableAutomaticUpgrade]
[-ExtensionType <String>]
[-ForceRerun <String>]
[-InstanceViewName <String>]
[-InstanceViewType <String>]
[-InstanceViewTypeHandlerVersion <String>]
[-ProtectedSetting <Hashtable>]
[-Publisher <String>]
[-Setting <Hashtable>]
[-StatusCode <String>]
[-StatusDisplayStatus <String>]
[-StatusLevel <String>]
[-StatusMessage <String>]
[-StatusTime <DateTime>]
[-Tag <Hashtable>]
[-TypeHandlerVersion <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzConnectedMachineExtension
-MachineName <String>
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-JsonString <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzConnectedMachineExtension
-MachineName <String>
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-JsonFilePath <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzConnectedMachineExtension
-MachineName <String>
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
-ExtensionParameter <IMachineExtension>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzConnectedMachineExtension
-Name <String>
-MachineInputObject <IConnectedMachineIdentity>
-Location <String>
[-AutoUpgradeMinorVersion]
[-EnableAutomaticUpgrade]
[-ExtensionType <String>]
[-ForceRerun <String>]
[-InstanceViewName <String>]
[-InstanceViewType <String>]
[-InstanceViewTypeHandlerVersion <String>]
[-ProtectedSetting <Hashtable>]
[-Publisher <String>]
[-Setting <Hashtable>]
[-StatusCode <String>]
[-StatusDisplayStatus <String>]
[-StatusLevel <String>]
[-StatusMessage <String>]
[-StatusTime <DateTime>]
[-Tag <Hashtable>]
[-TypeHandlerVersion <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzConnectedMachineExtension
-Name <String>
-MachineInputObject <IConnectedMachineIdentity>
-ExtensionParameter <IMachineExtension>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzConnectedMachineExtension
-InputObject <IConnectedMachineIdentity>
-Location <String>
[-AutoUpgradeMinorVersion]
[-EnableAutomaticUpgrade]
[-ExtensionType <String>]
[-ForceRerun <String>]
[-InstanceViewName <String>]
[-InstanceViewType <String>]
[-InstanceViewTypeHandlerVersion <String>]
[-ProtectedSetting <Hashtable>]
[-Publisher <String>]
[-Setting <Hashtable>]
[-StatusCode <String>]
[-StatusDisplayStatus <String>]
[-StatusLevel <String>]
[-StatusMessage <String>]
[-StatusTime <DateTime>]
[-Tag <Hashtable>]
[-TypeHandlerVersion <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzConnectedMachineExtension
-InputObject <IConnectedMachineIdentity>
-ExtensionParameter <IMachineExtension>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Opération de création de l’extension.
Exemples
Exemple 1 : Ajouter une nouvelle extension à un ordinateur
$Settings = @{ "commandToExecute" = "powershell.exe -c Get-Process" }
New-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName win-eastus1 -Location eastus -Publisher "Microsoft.Compute" -TypeHandlerVersion 1.10 -Settings $Settings -ExtensionType CustomScriptExtension
Name Location ProvisioningState
---- -------- -----------------
custom eastus Succeeded
Définit une extension sur une machine.
Exemple 2 : Ajouter une nouvelle extension avec des paramètres d’extension spécifiés via le pipeline
$otherExtension = Get-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName other
$otherExtension | New-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName important
Name Location ProvisioningState
---- -------- -----------------
custom eastus Succeeded
Cela crée une extension avec les paramètres d’extension fournis par l’objet transmis via le pipeline. C’est génial si vous souhaitez saisir les paramètres d’une machine et l’appliquer à un autre ordinateur.
Exemple 3 : Ajouter une nouvelle extension avec l’emplacement spécifié via le pipeline
$identity = [Microsoft.Azure.PowerShell.Cmdlets.ConnectedMachine.Models.ConnectedMachineIdentity]@{
Id = "/subscriptions/$($SubscriptionId)/resourceGroups/$($ResourceGroupName)/providers/Microsoft.HybridCompute/machines/$MachineName/extensions/$ExtensionName"
}
$Settings = @{ "commandToExecute" = "powershell.exe -c Get-Process" }
$identity | New-AzConnectedMachineExtension -Location eastus -Publisher "Microsoft.Compute" -TypeHandlerVersion 1.10 -Settings $Settings -ExtensionType CustomScriptExtension
Name Location ProvisioningState
---- -------- -----------------
custom eastus Succeeded
Cela crée une extension de machine à l’aide de l’identité fournie via le pipeline. Vous ne le ferez probablement pas, mais c’est possible.
Exemple 4 : Ajouter une nouvelle extension à l’aide d’un objet d’extension comme emplacement et paramètres pour la mise à jour
$ext = Get-AzConnectedMachineExtension -Name custom -ResourceGroupName ContosoTest -MachineName other
$ext | New-AzConnectedMachineExtension -ExtensionParameter $ext
Cela crée une extension de machine à l’aide de l’identité fournie via le pipeline et les détails de l’extension fournis par l’objet d’extension transmis. Vous ne le ferez probablement pas, mais c’est possible.
Paramètres
-AsJob
Exécuter la commande en tant que travail
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoUpgradeMinorVersion
Indique si l’extension doit utiliser une version mineure plus récente si elle est disponible au moment du déploiement. Cependant, une fois déployée, l’extension ne mettra pas à jour les versions mineures à moins d’être redéployée, même si cette propriété est définie sur true.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.
Type: | PSObject |
Aliases: | AzureRMContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAutomaticUpgrade
Indique si l’extension doit être automatiquement mise à niveau par la plateforme s’il existe une version plus récente disponible.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtensionParameter
Décrit une extension de machine.
Type: | IMachineExtension |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionType
Spécifie le type de l’extension ; un exemple est « CustomScriptExtension ».
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceRerun
Comment le gestionnaire d’extensions doit être forcé de mettre à jour même si la configuration de l’extension n’a pas changé.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Paramètre d’identité
Type: | IConnectedMachineIdentity |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InstanceViewName
Nom de l’extension de l’ordinateur.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceViewType
Spécifie le type de l’extension ; un exemple est « CustomScriptExtension ».
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceViewTypeHandlerVersion
Spécifie la version du gestionnaire de scripts.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JsonFilePath
Chemin d’accès du fichier Json fourni à l’opération Créer
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JsonString
Chaîne Json fournie à l’opération Create
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Emplacement géographique où réside la ressource
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MachineInputObject
Paramètre d’identité
Type: | IConnectedMachineIdentity |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MachineName
Nom de l’ordinateur sur lequel l’extension doit être créée ou mise à jour.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Nom de l’extension de machine.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NoWait
Exécuter la commande de manière asynchrone
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProtectedSetting
L’extension peut contenir des paramètres protégés Paramètres ou protégés Paramètres FromKeyVault ou aucun paramètre protégé du tout.
Type: | Hashtable |
Aliases: | ProtectedSettings |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Publisher
Nom du serveur de publication du gestionnaire d’extensions.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Nom du groupe de ressources. Le nom ne respecte pas la casse.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Setting
Paramètres publics au format Json pour l’extension.
Type: | Hashtable |
Aliases: | Settings |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StatusCode
Code d'état.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StatusDisplayStatus
Étiquette localisable courte pour l’état.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StatusLevel
Code de niveau.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StatusMessage
Message d’état détaillé, y compris pour les alertes et les messages d’erreur.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StatusTime
Heure de l’état.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubscriptionId
ID de l’abonnement cible.
Type: | String |
Position: | Named |
Default value: | (Get-AzContext).Subscription.Id |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Balises de ressource.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TypeHandlerVersion
Spécifie la version du gestionnaire de scripts.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Sorties
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour