Share via

Set-AzureVMDscExtension

  • Reference
Modul:
Azure

Nakonfiguruje rozšíření DSC na virtuálním počítači.

Poznámka:

Rutiny, na které odkazuje tato dokumentace, slouží ke správě starších prostředků Azure, které používají rozhraní API pro správu služeb. Informace o rutinách pro správu prostředků Azure Resource Manageru najdete v modulu Az PowerShell.

Syntax

Set-AzureVMDscExtension
   [-ReferenceName <String>]
   [-ConfigurationArgument <Hashtable>]
   [-ConfigurationDataPath <String>]
   [-ConfigurationArchive] <String>
   [-ConfigurationName <String>]
   [-ContainerName <String>]
   [-Force]
   [-StorageContext <AzureStorageContext>]
   [-Version <String>]
   [-StorageEndpointSuffix <String>]
   [-WmfVersion <String>]
   [-DataCollection <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Set-AzureVMDscExtension nakonfiguruje rozšíření DSC (Desired State Configuration) na virtuálním počítači.

Příklady

Příklad 1: Konfigurace rozšíření DSC na virtuálním počítači

PS C:\> Set-AzureVMDscExtension -VM $VM -ConfigurationArchive MyConfiguration.ps1.zip  -ConfigurationName MyConfiguration -ConfigurationArgument @{ Path = 'C:\MyDirectory' }
DeploymentName              : my-vm-svc
Name                        : my-vm
Label                       :
VM                          : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVM
InstanceStatus              : ReadyRole
IpAddress                   : 10.10.10.10
InstanceStateDetails        :
PowerState                  : Started
InstanceErrorCode           :
InstanceFaultDomain         : 0
InstanceName                : my-vm
InstanceUpgradeDomain       : 0
InstanceSize                : Small
AvailabilitySetName         :
DNSName                     : http://my-vm-svc.cloudapp.net/
Status                      : ReadyRole
GuestAgentStatus            : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus
ResourceExtensionStatusList : {Contoso.Compute.BGInfo}
PublicIPAddress             :
PublicIPName                :
ServiceName                 : my-vm-svc
OperationDescription        : Get-AzureVM
OperationId                 : a0217a7af900c1f8a212299a3333cdbd6
OperationStatus             : OK

Tento příkaz nakonfiguruje rozšíření DSC na virtuálním počítači.

Balíček MyConfiguration.ps1.zip musel být dříve odeslán do úložiště Azure pomocí příkazu Publish-AzureVMDscConfiguration a zahrnuje skript MyConfiguration.ps1 a moduly, na kterých závisí.

Argument MyConfiguration označuje konkrétní konfiguraci DSC v rámci skriptu, který se má spustit. Parametr -ConfigurationArgument určuje hashtable s argumenty předanými konfigurační funkci.

Příklad 2: Konfigurace rozšíření DSC na virtuálním počítači pomocí cesty ke konfiguračním datům

PS C:\> $VM | Set-AzureVMDscExtension -ConfigurationArchive MyConfiguration.ps1.zip  -ConfigurationName MyConfiguration -ConfigurationArgument @{ Credential = Get-Credential } -ConfigurationDataPath MyConfigurationData.psd1
DeploymentName              : my-vm-svc
Name                        : my-vm
Label                       :
VM                          : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVM
InstanceStatus              : ReadyRole
IpAddress                   : 10.10.10.10
InstanceStateDetails        :
PowerState                  : Started
InstanceErrorCode           :
InstanceFaultDomain         : 0
InstanceName                : my-vm
InstanceUpgradeDomain       : 0
InstanceSize                : Small
AvailabilitySetName         :
DNSName                     : http://my-vm-svc.cloudapp.net/
Status                      : ReadyRole
GuestAgentStatus            : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus
ResourceExtensionStatusList : {Microsoft.Compute.BGInfo, Microsoft.Powershell.DSC}
PublicIPAddress             :
PublicIPName                :
ServiceName                 : my-vm-svc
OperationDescription        : Get-AzureVM
OperationId                 : a0217a7af900c1f8a212299a3333cdbd7
OperationStatus             : OK

Tento příkaz nakonfiguruje rozšíření DSC na virtuálním počítači pomocí cesty ke konfiguračním datům.

Parametry

-ConfigurationArchive

Určuje název konfiguračního balíčku (soubor ZIP), který byl dříve nahraný nástrojem Publish-AzureVMDscConfiguration. Tento parametr musí zadat pouze název souboru bez jakékoli cesty.

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

-ConfigurationArgument

Určuje hashovací tabulku určující argumenty konfigurační funkce. Klíče odpovídají názvům parametrů a hodnotám parametrů.

Přijatelné hodnoty pro tento parametr jsou:

  • primitivní typy
  • řetězec
  • pole
  • PsCredential
Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationDataPath

Určuje cestu k souboru .psd1, který určuje data pro konfigurační funkci. Tento soubor musí obsahovat hashtable, jak je popsáno v části Oddělení dat konfigurace a prostředí.https://msdn.microsoft.com/en-us/PowerShell/DSC/configData.

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

-ConfigurationName

Určuje název konfiguračního skriptu nebo modulu, který je vyvolán rozšířením DSC.

Hodnota tohoto parametru musí být název jedné z konfiguračních funkcí obsažených ve skriptech nebo modulech zabalených v ConfigurationArchive.

Pokud tento parametr vynecháte, vyloučíte-li tento parametr, tato rutina ve výchozím nastavení nastaví název souboru zadaného parametrem ConfigurationArchive . Pokud je například ConfigurationArchive "SalesWebSite.ps1.zip", výchozí hodnota configurationName je "SalesWebSite".

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

-Confirm

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

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

-ContainerName

Určuje název kontejneru úložiště Azure, ve kterém se nachází ConfigurationArchive .

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

-DataCollection

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

-Force

Označuje, že tato rutina přepíše existující objekty blob.

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

-InformationAction

Určuje, jak tato rutina reaguje na informační událost.

Přijatelné hodnoty pro tento parametr jsou:

  • Pokračovat
  • Ignorovat
  • Dotazem
  • SilentlyContinue
  • Zastavit
  • Suspend
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Určuje informační proměnnou.

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

-Profile

Určuje profil Azure, ze kterého se tato rutina čte. Pokud nezadáte profil, tato rutina načte z místního výchozího profilu.

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

-ReferenceName

Určuje uživatelem definovaný řetězec, který lze použít k odkazování na rozšíření. Tento parametr se zadává při prvním přidání rozšíření do virtuálního počítače. V případě následných aktualizací byste při aktualizaci rozšíření měli zadat dříve použitý název odkazu. ReferenceName přiřazené k rozšíření se vrátí pomocí rutiny Get-AzureVM.

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

-StorageContext

Určuje kontext úložiště Azure, který poskytuje nastavení zabezpečení používané pro přístup ke konfiguračnímu skriptu. Tento kontext poskytuje přístup pro čtení ke kontejneru určenému parametrem ContainerName .

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

-StorageEndpointSuffix

Určuje příponu koncového bodu DNS pro všechny služby úložiště, například "core.contoso.net".

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

-Version

Určuje konkrétní verzi rozšíření DSC, která se má použít. Výchozí hodnota je nastavena na hodnotu 1.*, pokud tento parametr není zadán.

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

-VM

Určuje trvalý objekt virtuálního počítače.

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

-WhatIf

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

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

-WmfVersion

Určuje verzi rozhraní WMF (Windows Management Framework) pro instalaci na virtuální počítač. Rozšíření DSC závisí na funkcích DSC, které jsou dostupné pouze v aktualizacích WMF. Tento parametr určuje, která verze aktualizace se má nainstalovat na virtuální počítač. Přijatelné hodnoty pro tento parametr jsou:

  • 4.0. Nainstaluje WMF 4.0, pokud ještě není nainstalovaná novější verze.
  • 5.0. Nainstaluje nejnovější verzi WMF 5.0.
  • Nejnovější. Nainstaluje nejnovější WMF, aktuálně WMF 5.0.

Výchozí hodnota je nejnovější.

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